Compare commits
6 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
65e4db153b | ||
|
|
8dbff66ce1 | ||
|
|
e62c49434c | ||
|
|
8f6eebc43b | ||
|
|
817cfddabc | ||
|
|
94e1806112 |
@@ -69,6 +69,7 @@ docs/agents/ RPI skill artifacts (research reports, plans)
|
|||||||
- **oxlint** for type-aware linting that Biome can't do. Configured in `.oxlintrc.json`.
|
- **oxlint** for type-aware linting that Biome can't do. Configured in `.oxlintrc.json`.
|
||||||
- **TypeScript strict mode** with `verbatimModuleSyntax`. Use `.js` extensions in relative imports.
|
- **TypeScript strict mode** with `verbatimModuleSyntax`. Use `.js` extensions in relative imports.
|
||||||
- **Branded types** for identity values (e.g., `CombatantId`). Prefer immutability/`readonly` where practical.
|
- **Branded types** for identity values (e.g., `CombatantId`). Prefer immutability/`readonly` where practical.
|
||||||
|
- **Reuse UI primitives** — before creating custom interactive elements (buttons, inputs, selects, dialogs), check `apps/web/src/components/ui/` for existing components with established variants and hover styles.
|
||||||
- **Domain events** are plain data objects with a `type` discriminant — no classes.
|
- **Domain events** are plain data objects with a `type` discriminant — no classes.
|
||||||
- **Tests** live in `__tests__/` directories adjacent to source. See the Testing section below for conventions on mocking, assertions, and per-layer approach.
|
- **Tests** live in `__tests__/` directories adjacent to source. See the Testing section below for conventions on mocking, assertions, and per-layer approach.
|
||||||
- **Quality gates** are enforced at pre-commit via Lefthook (parallel jobs). No gate may exist only as a CI step or manual process.
|
- **Quality gates** are enforced at pre-commit via Lefthook (parallel jobs). No gate may exist only as a CI step or manual process.
|
||||||
|
|||||||
@@ -29,6 +29,6 @@
|
|||||||
"@vitejs/plugin-react": "^6.0.1",
|
"@vitejs/plugin-react": "^6.0.1",
|
||||||
"jsdom": "^29.0.1",
|
"jsdom": "^29.0.1",
|
||||||
"tailwindcss": "^4.2.2",
|
"tailwindcss": "^4.2.2",
|
||||||
"vite": "^8.0.1"
|
"vite": "^8.0.5"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
import {
|
import {
|
||||||
type Creature,
|
type AnyCreature,
|
||||||
type CreatureId,
|
type CreatureId,
|
||||||
EMPTY_UNDO_REDO_STATE,
|
EMPTY_UNDO_REDO_STATE,
|
||||||
type Encounter,
|
type Encounter,
|
||||||
@@ -12,10 +12,10 @@ export function createTestAdapters(options?: {
|
|||||||
encounter?: Encounter | null;
|
encounter?: Encounter | null;
|
||||||
undoRedoState?: UndoRedoState;
|
undoRedoState?: UndoRedoState;
|
||||||
playerCharacters?: PlayerCharacter[];
|
playerCharacters?: PlayerCharacter[];
|
||||||
creatures?: Map<CreatureId, Creature>;
|
creatures?: Map<CreatureId, AnyCreature>;
|
||||||
sources?: Map<
|
sources?: Map<
|
||||||
string,
|
string,
|
||||||
{ displayName: string; creatures: Creature[]; cachedAt: number }
|
{ displayName: string; creatures: AnyCreature[]; cachedAt: number }
|
||||||
>;
|
>;
|
||||||
}): Adapters {
|
}): Adapters {
|
||||||
let storedEncounter = options?.encounter ?? null;
|
let storedEncounter = options?.encounter ?? null;
|
||||||
@@ -25,7 +25,7 @@ export function createTestAdapters(options?: {
|
|||||||
options?.sources ??
|
options?.sources ??
|
||||||
new Map<
|
new Map<
|
||||||
string,
|
string,
|
||||||
{ displayName: string; creatures: Creature[]; cachedAt: number }
|
{ displayName: string; creatures: AnyCreature[]; cachedAt: number }
|
||||||
>();
|
>();
|
||||||
|
|
||||||
// Pre-populate sourceStore from creatures map if provided
|
// Pre-populate sourceStore from creatures map if provided
|
||||||
@@ -33,7 +33,7 @@ export function createTestAdapters(options?: {
|
|||||||
// No-op: creatures are accessed directly from the map
|
// No-op: creatures are accessed directly from the map
|
||||||
}
|
}
|
||||||
|
|
||||||
const creatureMap = options?.creatures ?? new Map<CreatureId, Creature>();
|
const creatureMap = options?.creatures ?? new Map<CreatureId, AnyCreature>();
|
||||||
|
|
||||||
return {
|
return {
|
||||||
encounterPersistence: {
|
encounterPersistence: {
|
||||||
@@ -55,8 +55,9 @@ export function createTestAdapters(options?: {
|
|||||||
},
|
},
|
||||||
},
|
},
|
||||||
bestiaryCache: {
|
bestiaryCache: {
|
||||||
cacheSource(sourceCode, displayName, creatures) {
|
cacheSource(system, sourceCode, displayName, creatures) {
|
||||||
sourceStore.set(sourceCode, {
|
const key = `${system}:${sourceCode}`;
|
||||||
|
sourceStore.set(key, {
|
||||||
displayName,
|
displayName,
|
||||||
creatures,
|
creatures,
|
||||||
cachedAt: Date.now(),
|
cachedAt: Date.now(),
|
||||||
@@ -66,21 +67,25 @@ export function createTestAdapters(options?: {
|
|||||||
}
|
}
|
||||||
return Promise.resolve();
|
return Promise.resolve();
|
||||||
},
|
},
|
||||||
isSourceCached(sourceCode) {
|
isSourceCached(system, sourceCode) {
|
||||||
return Promise.resolve(sourceStore.has(sourceCode));
|
return Promise.resolve(sourceStore.has(`${system}:${sourceCode}`));
|
||||||
},
|
},
|
||||||
getCachedSources() {
|
getCachedSources(system) {
|
||||||
return Promise.resolve(
|
return Promise.resolve(
|
||||||
[...sourceStore.entries()].map(([sourceCode, info]) => ({
|
[...sourceStore.entries()]
|
||||||
sourceCode,
|
.filter(([key]) => !system || key.startsWith(`${system}:`))
|
||||||
|
.map(([key, info]) => ({
|
||||||
|
sourceCode: key.includes(":")
|
||||||
|
? key.slice(key.indexOf(":") + 1)
|
||||||
|
: key,
|
||||||
displayName: info.displayName,
|
displayName: info.displayName,
|
||||||
creatureCount: info.creatures.length,
|
creatureCount: info.creatures.length,
|
||||||
cachedAt: info.cachedAt,
|
cachedAt: info.cachedAt,
|
||||||
})),
|
})),
|
||||||
);
|
);
|
||||||
},
|
},
|
||||||
clearSource(sourceCode) {
|
clearSource(system, sourceCode) {
|
||||||
sourceStore.delete(sourceCode);
|
sourceStore.delete(`${system}:${sourceCode}`);
|
||||||
return Promise.resolve();
|
return Promise.resolve();
|
||||||
},
|
},
|
||||||
clearAll() {
|
clearAll() {
|
||||||
@@ -104,5 +109,12 @@ export function createTestAdapters(options?: {
|
|||||||
},
|
},
|
||||||
getSourceDisplayName: (sourceCode) => sourceCode,
|
getSourceDisplayName: (sourceCode) => sourceCode,
|
||||||
},
|
},
|
||||||
|
pf2eBestiaryIndex: {
|
||||||
|
loadIndex: () => ({ sources: {}, creatures: [] }),
|
||||||
|
getAllSourceCodes: () => [],
|
||||||
|
getDefaultFetchUrl: (sourceCode) =>
|
||||||
|
`https://example.com/creatures-${sourceCode.toLowerCase()}.json`,
|
||||||
|
getSourceDisplayName: (sourceCode) => sourceCode,
|
||||||
|
},
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -234,6 +234,57 @@ describe("round-trip: export then import", () => {
|
|||||||
expect(imported.encounter.combatants[0].cr).toBe("2");
|
expect(imported.encounter.combatants[0].cr).toBe("2");
|
||||||
});
|
});
|
||||||
|
|
||||||
|
it("round-trips a combatant with side field", () => {
|
||||||
|
const encounterWithSide: Encounter = {
|
||||||
|
combatants: [
|
||||||
|
{
|
||||||
|
id: combatantId("c-1"),
|
||||||
|
name: "Allied Guard",
|
||||||
|
cr: "2",
|
||||||
|
side: "party",
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: combatantId("c-2"),
|
||||||
|
name: "Goblin",
|
||||||
|
side: "enemy",
|
||||||
|
},
|
||||||
|
],
|
||||||
|
activeIndex: 0,
|
||||||
|
roundNumber: 1,
|
||||||
|
};
|
||||||
|
const emptyUndoRedo: UndoRedoState = {
|
||||||
|
undoStack: [],
|
||||||
|
redoStack: [],
|
||||||
|
};
|
||||||
|
const bundle = assembleExportBundle(encounterWithSide, emptyUndoRedo, []);
|
||||||
|
const serialized = JSON.parse(JSON.stringify(bundle));
|
||||||
|
const result = validateImportBundle(serialized);
|
||||||
|
|
||||||
|
expect(typeof result).toBe("object");
|
||||||
|
const imported = result as ExportBundle;
|
||||||
|
expect(imported.encounter.combatants[0].side).toBe("party");
|
||||||
|
expect(imported.encounter.combatants[1].side).toBe("enemy");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("round-trips a combatant without side field as undefined", () => {
|
||||||
|
const encounterNoSide: Encounter = {
|
||||||
|
combatants: [{ id: combatantId("c-1"), name: "Custom" }],
|
||||||
|
activeIndex: 0,
|
||||||
|
roundNumber: 1,
|
||||||
|
};
|
||||||
|
const emptyUndoRedo: UndoRedoState = {
|
||||||
|
undoStack: [],
|
||||||
|
redoStack: [],
|
||||||
|
};
|
||||||
|
const bundle = assembleExportBundle(encounterNoSide, emptyUndoRedo, []);
|
||||||
|
const serialized = JSON.parse(JSON.stringify(bundle));
|
||||||
|
const result = validateImportBundle(serialized);
|
||||||
|
|
||||||
|
expect(typeof result).toBe("object");
|
||||||
|
const imported = result as ExportBundle;
|
||||||
|
expect(imported.encounter.combatants[0].side).toBeUndefined();
|
||||||
|
});
|
||||||
|
|
||||||
it("round-trips an empty encounter", () => {
|
it("round-trips an empty encounter", () => {
|
||||||
const emptyEncounter: Encounter = {
|
const emptyEncounter: Encounter = {
|
||||||
combatants: [],
|
combatants: [],
|
||||||
|
|||||||
@@ -1,9 +1,24 @@
|
|||||||
|
import type { TraitBlock } from "@initiative/domain";
|
||||||
import { beforeAll, describe, expect, it } from "vitest";
|
import { beforeAll, describe, expect, it } from "vitest";
|
||||||
import {
|
import {
|
||||||
normalizeBestiary,
|
normalizeBestiary,
|
||||||
setSourceDisplayNames,
|
setSourceDisplayNames,
|
||||||
} from "../bestiary-adapter.js";
|
} from "../bestiary-adapter.js";
|
||||||
|
|
||||||
|
/** Flatten segments to a single string for simple text assertions. */
|
||||||
|
function flatText(trait: TraitBlock | undefined): string {
|
||||||
|
if (!trait) return "";
|
||||||
|
return trait.segments
|
||||||
|
.map((s) =>
|
||||||
|
s.type === "text"
|
||||||
|
? s.value
|
||||||
|
: s.items
|
||||||
|
.map((i) => (i.label ? `${i.label}. ${i.text}` : i.text))
|
||||||
|
.join(" "),
|
||||||
|
)
|
||||||
|
.join(" ");
|
||||||
|
}
|
||||||
|
|
||||||
beforeAll(() => {
|
beforeAll(() => {
|
||||||
setSourceDisplayNames({ XMM: "MM 2024" });
|
setSourceDisplayNames({ XMM: "MM 2024" });
|
||||||
});
|
});
|
||||||
@@ -74,11 +89,11 @@ describe("normalizeBestiary", () => {
|
|||||||
expect(c.senses).toBe("Darkvision 60 ft.");
|
expect(c.senses).toBe("Darkvision 60 ft.");
|
||||||
expect(c.languages).toBe("Common, Goblin");
|
expect(c.languages).toBe("Common, Goblin");
|
||||||
expect(c.actions).toHaveLength(1);
|
expect(c.actions).toHaveLength(1);
|
||||||
expect(c.actions?.[0].text).toContain("Melee Attack Roll:");
|
expect(flatText(c.actions?.[0])).toContain("Melee Attack Roll:");
|
||||||
expect(c.actions?.[0].text).not.toContain("{@");
|
expect(flatText(c.actions?.[0])).not.toContain("{@");
|
||||||
expect(c.bonusActions).toHaveLength(1);
|
expect(c.bonusActions).toHaveLength(1);
|
||||||
expect(c.bonusActions?.[0].text).toContain("Disengage");
|
expect(flatText(c.bonusActions?.[0])).toContain("Disengage");
|
||||||
expect(c.bonusActions?.[0].text).not.toContain("{@");
|
expect(flatText(c.bonusActions?.[0])).not.toContain("{@");
|
||||||
});
|
});
|
||||||
|
|
||||||
it("normalizes a creature with legendary actions", () => {
|
it("normalizes a creature with legendary actions", () => {
|
||||||
@@ -333,9 +348,9 @@ describe("normalizeBestiary", () => {
|
|||||||
|
|
||||||
const creatures = normalizeBestiary(raw);
|
const creatures = normalizeBestiary(raw);
|
||||||
const bite = creatures[0].actions?.[0];
|
const bite = creatures[0].actions?.[0];
|
||||||
expect(bite?.text).toContain("Melee Weapon Attack:");
|
expect(flatText(bite)).toContain("Melee Weapon Attack:");
|
||||||
expect(bite?.text).not.toContain("mw");
|
expect(flatText(bite)).not.toContain("mw");
|
||||||
expect(bite?.text).not.toContain("{@");
|
expect(flatText(bite)).not.toContain("{@");
|
||||||
});
|
});
|
||||||
|
|
||||||
it("handles fly speed with hover condition", () => {
|
it("handles fly speed with hover condition", () => {
|
||||||
@@ -368,4 +383,131 @@ describe("normalizeBestiary", () => {
|
|||||||
const creatures = normalizeBestiary(raw);
|
const creatures = normalizeBestiary(raw);
|
||||||
expect(creatures[0].speed).toBe("10 ft., fly 90 ft. (hover)");
|
expect(creatures[0].speed).toBe("10 ft., fly 90 ft. (hover)");
|
||||||
});
|
});
|
||||||
|
|
||||||
|
it("renders list items with singular entry field (e.g. Confusing Burble d4 effects)", () => {
|
||||||
|
const raw = {
|
||||||
|
monster: [
|
||||||
|
{
|
||||||
|
name: "Jabberwock",
|
||||||
|
source: "WBtW",
|
||||||
|
size: ["H"],
|
||||||
|
type: "dragon",
|
||||||
|
ac: [18],
|
||||||
|
hp: { average: 115, formula: "10d12 + 50" },
|
||||||
|
speed: { walk: 30 },
|
||||||
|
str: 22,
|
||||||
|
dex: 15,
|
||||||
|
con: 20,
|
||||||
|
int: 8,
|
||||||
|
wis: 14,
|
||||||
|
cha: 16,
|
||||||
|
passive: 12,
|
||||||
|
cr: "13",
|
||||||
|
trait: [
|
||||||
|
{
|
||||||
|
name: "Confusing Burble",
|
||||||
|
entries: [
|
||||||
|
"The jabberwock burbles unless {@condition incapacitated}. Roll a {@dice d4}:",
|
||||||
|
{
|
||||||
|
type: "list",
|
||||||
|
style: "list-hang-notitle",
|
||||||
|
items: [
|
||||||
|
{
|
||||||
|
type: "item",
|
||||||
|
name: "1-2",
|
||||||
|
entry: "The creature does nothing.",
|
||||||
|
},
|
||||||
|
{
|
||||||
|
type: "item",
|
||||||
|
name: "3",
|
||||||
|
entry:
|
||||||
|
"The creature uses all its movement to move in a random direction.",
|
||||||
|
},
|
||||||
|
{
|
||||||
|
type: "item",
|
||||||
|
name: "4",
|
||||||
|
entry:
|
||||||
|
"The creature makes one melee attack against a random creature.",
|
||||||
|
},
|
||||||
|
],
|
||||||
|
},
|
||||||
|
],
|
||||||
|
},
|
||||||
|
],
|
||||||
|
},
|
||||||
|
],
|
||||||
|
};
|
||||||
|
|
||||||
|
const creatures = normalizeBestiary(raw);
|
||||||
|
const trait = creatures[0].traits?.[0];
|
||||||
|
expect(trait).toBeDefined();
|
||||||
|
expect(trait?.name).toBe("Confusing Burble");
|
||||||
|
expect(trait?.segments).toHaveLength(2);
|
||||||
|
expect(trait?.segments[0]).toEqual({
|
||||||
|
type: "text",
|
||||||
|
value: expect.stringContaining("d4"),
|
||||||
|
});
|
||||||
|
expect(trait?.segments[1]).toEqual({
|
||||||
|
type: "list",
|
||||||
|
items: [
|
||||||
|
{ label: "1-2", text: "The creature does nothing." },
|
||||||
|
{
|
||||||
|
label: "3",
|
||||||
|
text: expect.stringContaining("random direction"),
|
||||||
|
},
|
||||||
|
{ label: "4", text: expect.stringContaining("melee attack") },
|
||||||
|
],
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
it("renders table entries as structured list segments", () => {
|
||||||
|
const raw = {
|
||||||
|
monster: [
|
||||||
|
{
|
||||||
|
name: "Test Creature",
|
||||||
|
source: "XMM",
|
||||||
|
size: ["M"],
|
||||||
|
type: "humanoid",
|
||||||
|
ac: [12],
|
||||||
|
hp: { average: 40, formula: "9d8" },
|
||||||
|
speed: { walk: 30 },
|
||||||
|
str: 10,
|
||||||
|
dex: 10,
|
||||||
|
con: 10,
|
||||||
|
int: 10,
|
||||||
|
wis: 10,
|
||||||
|
cha: 10,
|
||||||
|
passive: 10,
|
||||||
|
cr: "1",
|
||||||
|
trait: [
|
||||||
|
{
|
||||||
|
name: "Random Effect",
|
||||||
|
entries: [
|
||||||
|
"Roll on the table:",
|
||||||
|
{
|
||||||
|
type: "table",
|
||||||
|
colLabels: ["d4", "Effect"],
|
||||||
|
rows: [
|
||||||
|
["1", "Nothing happens."],
|
||||||
|
["2", "Something happens."],
|
||||||
|
],
|
||||||
|
},
|
||||||
|
],
|
||||||
|
},
|
||||||
|
],
|
||||||
|
},
|
||||||
|
],
|
||||||
|
};
|
||||||
|
|
||||||
|
const creatures = normalizeBestiary(raw);
|
||||||
|
const trait = creatures[0].traits?.[0];
|
||||||
|
expect(trait).toBeDefined();
|
||||||
|
expect(trait?.segments[1]).toEqual({
|
||||||
|
type: "list",
|
||||||
|
items: [
|
||||||
|
{ label: "1", text: "Nothing happens." },
|
||||||
|
{ label: "2", text: "Something happens." },
|
||||||
|
],
|
||||||
|
});
|
||||||
|
});
|
||||||
});
|
});
|
||||||
|
|||||||
@@ -46,17 +46,17 @@ describe("bestiary-cache fallback (IndexedDB unavailable)", () => {
|
|||||||
|
|
||||||
it("cacheSource falls back to in-memory store", async () => {
|
it("cacheSource falls back to in-memory store", async () => {
|
||||||
const creatures = [makeCreature("mm:goblin", "Goblin")];
|
const creatures = [makeCreature("mm:goblin", "Goblin")];
|
||||||
await cacheSource("MM", "Monster Manual", creatures);
|
await cacheSource("dnd", "MM", "Monster Manual", creatures);
|
||||||
|
|
||||||
expect(await isSourceCached("MM")).toBe(true);
|
expect(await isSourceCached("dnd", "MM")).toBe(true);
|
||||||
});
|
});
|
||||||
|
|
||||||
it("isSourceCached returns false for uncached source", async () => {
|
it("isSourceCached returns false for uncached source", async () => {
|
||||||
expect(await isSourceCached("XGE")).toBe(false);
|
expect(await isSourceCached("dnd", "XGE")).toBe(false);
|
||||||
});
|
});
|
||||||
|
|
||||||
it("getCachedSources returns sources from in-memory store", async () => {
|
it("getCachedSources returns sources from in-memory store", async () => {
|
||||||
await cacheSource("MM", "Monster Manual", [
|
await cacheSource("dnd", "MM", "Monster Manual", [
|
||||||
makeCreature("mm:goblin", "Goblin"),
|
makeCreature("mm:goblin", "Goblin"),
|
||||||
]);
|
]);
|
||||||
|
|
||||||
@@ -68,7 +68,7 @@ describe("bestiary-cache fallback (IndexedDB unavailable)", () => {
|
|||||||
|
|
||||||
it("loadAllCachedCreatures assembles creatures from in-memory store", async () => {
|
it("loadAllCachedCreatures assembles creatures from in-memory store", async () => {
|
||||||
const goblin = makeCreature("mm:goblin", "Goblin");
|
const goblin = makeCreature("mm:goblin", "Goblin");
|
||||||
await cacheSource("MM", "Monster Manual", [goblin]);
|
await cacheSource("dnd", "MM", "Monster Manual", [goblin]);
|
||||||
|
|
||||||
const map = await loadAllCachedCreatures();
|
const map = await loadAllCachedCreatures();
|
||||||
expect(map.size).toBe(1);
|
expect(map.size).toBe(1);
|
||||||
@@ -76,17 +76,17 @@ describe("bestiary-cache fallback (IndexedDB unavailable)", () => {
|
|||||||
});
|
});
|
||||||
|
|
||||||
it("clearSource removes a single source from in-memory store", async () => {
|
it("clearSource removes a single source from in-memory store", async () => {
|
||||||
await cacheSource("MM", "Monster Manual", []);
|
await cacheSource("dnd", "MM", "Monster Manual", []);
|
||||||
await cacheSource("VGM", "Volo's Guide", []);
|
await cacheSource("dnd", "VGM", "Volo's Guide", []);
|
||||||
|
|
||||||
await clearSource("MM");
|
await clearSource("dnd", "MM");
|
||||||
|
|
||||||
expect(await isSourceCached("MM")).toBe(false);
|
expect(await isSourceCached("dnd", "MM")).toBe(false);
|
||||||
expect(await isSourceCached("VGM")).toBe(true);
|
expect(await isSourceCached("dnd", "VGM")).toBe(true);
|
||||||
});
|
});
|
||||||
|
|
||||||
it("clearAll removes all data from in-memory store", async () => {
|
it("clearAll removes all data from in-memory store", async () => {
|
||||||
await cacheSource("MM", "Monster Manual", []);
|
await cacheSource("dnd", "MM", "Monster Manual", []);
|
||||||
await clearAll();
|
await clearAll();
|
||||||
|
|
||||||
const sources = await getCachedSources();
|
const sources = await getCachedSources();
|
||||||
|
|||||||
@@ -69,17 +69,17 @@ describe("bestiary-cache", () => {
|
|||||||
describe("cacheSource", () => {
|
describe("cacheSource", () => {
|
||||||
it("stores creatures and metadata", async () => {
|
it("stores creatures and metadata", async () => {
|
||||||
const creatures = [makeCreature("mm:goblin", "Goblin")];
|
const creatures = [makeCreature("mm:goblin", "Goblin")];
|
||||||
await cacheSource("MM", "Monster Manual", creatures);
|
await cacheSource("dnd", "MM", "Monster Manual", creatures);
|
||||||
|
|
||||||
expect(fakeStore.has("MM")).toBe(true);
|
expect(fakeStore.has("dnd:MM")).toBe(true);
|
||||||
const record = fakeStore.get("MM") as {
|
const record = fakeStore.get("dnd:MM") as {
|
||||||
sourceCode: string;
|
sourceCode: string;
|
||||||
displayName: string;
|
displayName: string;
|
||||||
creatures: Creature[];
|
creatures: Creature[];
|
||||||
creatureCount: number;
|
creatureCount: number;
|
||||||
cachedAt: number;
|
cachedAt: number;
|
||||||
};
|
};
|
||||||
expect(record.sourceCode).toBe("MM");
|
expect(record.sourceCode).toBe("dnd:MM");
|
||||||
expect(record.displayName).toBe("Monster Manual");
|
expect(record.displayName).toBe("Monster Manual");
|
||||||
expect(record.creatures).toHaveLength(1);
|
expect(record.creatures).toHaveLength(1);
|
||||||
expect(record.creatureCount).toBe(1);
|
expect(record.creatureCount).toBe(1);
|
||||||
@@ -89,12 +89,12 @@ describe("bestiary-cache", () => {
|
|||||||
|
|
||||||
describe("isSourceCached", () => {
|
describe("isSourceCached", () => {
|
||||||
it("returns false for uncached source", async () => {
|
it("returns false for uncached source", async () => {
|
||||||
expect(await isSourceCached("XGE")).toBe(false);
|
expect(await isSourceCached("dnd", "XGE")).toBe(false);
|
||||||
});
|
});
|
||||||
|
|
||||||
it("returns true after caching", async () => {
|
it("returns true after caching", async () => {
|
||||||
await cacheSource("MM", "Monster Manual", []);
|
await cacheSource("dnd", "MM", "Monster Manual", []);
|
||||||
expect(await isSourceCached("MM")).toBe(true);
|
expect(await isSourceCached("dnd", "MM")).toBe(true);
|
||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
@@ -105,11 +105,11 @@ describe("bestiary-cache", () => {
|
|||||||
});
|
});
|
||||||
|
|
||||||
it("returns source info with creature counts", async () => {
|
it("returns source info with creature counts", async () => {
|
||||||
await cacheSource("MM", "Monster Manual", [
|
await cacheSource("dnd", "MM", "Monster Manual", [
|
||||||
makeCreature("mm:goblin", "Goblin"),
|
makeCreature("mm:goblin", "Goblin"),
|
||||||
makeCreature("mm:orc", "Orc"),
|
makeCreature("mm:orc", "Orc"),
|
||||||
]);
|
]);
|
||||||
await cacheSource("VGM", "Volo's Guide", [
|
await cacheSource("dnd", "VGM", "Volo's Guide", [
|
||||||
makeCreature("vgm:flind", "Flind"),
|
makeCreature("vgm:flind", "Flind"),
|
||||||
]);
|
]);
|
||||||
|
|
||||||
@@ -137,8 +137,8 @@ describe("bestiary-cache", () => {
|
|||||||
const orc = makeCreature("mm:orc", "Orc");
|
const orc = makeCreature("mm:orc", "Orc");
|
||||||
const flind = makeCreature("vgm:flind", "Flind");
|
const flind = makeCreature("vgm:flind", "Flind");
|
||||||
|
|
||||||
await cacheSource("MM", "Monster Manual", [goblin, orc]);
|
await cacheSource("dnd", "MM", "Monster Manual", [goblin, orc]);
|
||||||
await cacheSource("VGM", "Volo's Guide", [flind]);
|
await cacheSource("dnd", "VGM", "Volo's Guide", [flind]);
|
||||||
|
|
||||||
const map = await loadAllCachedCreatures();
|
const map = await loadAllCachedCreatures();
|
||||||
expect(map.size).toBe(3);
|
expect(map.size).toBe(3);
|
||||||
@@ -150,20 +150,20 @@ describe("bestiary-cache", () => {
|
|||||||
|
|
||||||
describe("clearSource", () => {
|
describe("clearSource", () => {
|
||||||
it("removes a single source", async () => {
|
it("removes a single source", async () => {
|
||||||
await cacheSource("MM", "Monster Manual", []);
|
await cacheSource("dnd", "MM", "Monster Manual", []);
|
||||||
await cacheSource("VGM", "Volo's Guide", []);
|
await cacheSource("dnd", "VGM", "Volo's Guide", []);
|
||||||
|
|
||||||
await clearSource("MM");
|
await clearSource("dnd", "MM");
|
||||||
|
|
||||||
expect(await isSourceCached("MM")).toBe(false);
|
expect(await isSourceCached("dnd", "MM")).toBe(false);
|
||||||
expect(await isSourceCached("VGM")).toBe(true);
|
expect(await isSourceCached("dnd", "VGM")).toBe(true);
|
||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
describe("clearAll", () => {
|
describe("clearAll", () => {
|
||||||
it("removes all cached data", async () => {
|
it("removes all cached data", async () => {
|
||||||
await cacheSource("MM", "Monster Manual", []);
|
await cacheSource("dnd", "MM", "Monster Manual", []);
|
||||||
await cacheSource("VGM", "Volo's Guide", []);
|
await cacheSource("dnd", "VGM", "Volo's Guide", []);
|
||||||
|
|
||||||
await clearAll();
|
await clearAll();
|
||||||
|
|
||||||
|
|||||||
172
apps/web/src/adapters/__tests__/pf2e-bestiary-adapter.test.ts
Normal file
172
apps/web/src/adapters/__tests__/pf2e-bestiary-adapter.test.ts
Normal file
@@ -0,0 +1,172 @@
|
|||||||
|
import { describe, expect, it } from "vitest";
|
||||||
|
import { normalizePf2eBestiary } from "../pf2e-bestiary-adapter.js";
|
||||||
|
|
||||||
|
function minimalCreature(overrides?: Record<string, unknown>) {
|
||||||
|
return {
|
||||||
|
name: "Test Creature",
|
||||||
|
source: "TST",
|
||||||
|
...overrides,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
describe("normalizePf2eBestiary", () => {
|
||||||
|
describe("weaknesses formatting", () => {
|
||||||
|
it("formats weakness with numeric amount", () => {
|
||||||
|
const [creature] = normalizePf2eBestiary({
|
||||||
|
creature: [
|
||||||
|
minimalCreature({
|
||||||
|
defenses: {
|
||||||
|
weaknesses: [{ name: "fire", amount: 5 }],
|
||||||
|
},
|
||||||
|
}),
|
||||||
|
],
|
||||||
|
});
|
||||||
|
expect(creature.weaknesses).toBe("Fire 5");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("formats weakness without amount (qualitative)", () => {
|
||||||
|
const [creature] = normalizePf2eBestiary({
|
||||||
|
creature: [
|
||||||
|
minimalCreature({
|
||||||
|
defenses: {
|
||||||
|
weaknesses: [{ name: "smoke susceptibility" }],
|
||||||
|
},
|
||||||
|
}),
|
||||||
|
],
|
||||||
|
});
|
||||||
|
expect(creature.weaknesses).toBe("Smoke susceptibility");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("formats weakness with note and amount", () => {
|
||||||
|
const [creature] = normalizePf2eBestiary({
|
||||||
|
creature: [
|
||||||
|
minimalCreature({
|
||||||
|
defenses: {
|
||||||
|
weaknesses: [
|
||||||
|
{ name: "cold iron", amount: 5, note: "except daggers" },
|
||||||
|
],
|
||||||
|
},
|
||||||
|
}),
|
||||||
|
],
|
||||||
|
});
|
||||||
|
expect(creature.weaknesses).toBe("Cold iron 5 (except daggers)");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("formats weakness with note but no amount", () => {
|
||||||
|
const [creature] = normalizePf2eBestiary({
|
||||||
|
creature: [
|
||||||
|
minimalCreature({
|
||||||
|
defenses: {
|
||||||
|
weaknesses: [{ name: "smoke susceptibility", note: "see below" }],
|
||||||
|
},
|
||||||
|
}),
|
||||||
|
],
|
||||||
|
});
|
||||||
|
expect(creature.weaknesses).toBe("Smoke susceptibility (see below)");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("returns undefined when no weaknesses", () => {
|
||||||
|
const [creature] = normalizePf2eBestiary({
|
||||||
|
creature: [minimalCreature({})],
|
||||||
|
});
|
||||||
|
expect(creature.weaknesses).toBeUndefined();
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe("senses formatting", () => {
|
||||||
|
it("strips tags and includes type and range", () => {
|
||||||
|
const [creature] = normalizePf2eBestiary({
|
||||||
|
creature: [
|
||||||
|
minimalCreature({
|
||||||
|
senses: [
|
||||||
|
{
|
||||||
|
type: "imprecise",
|
||||||
|
name: "{@ability tremorsense}",
|
||||||
|
range: 30,
|
||||||
|
},
|
||||||
|
],
|
||||||
|
}),
|
||||||
|
],
|
||||||
|
});
|
||||||
|
expect(creature.senses).toBe("Tremorsense (imprecise) 30 feet");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("formats sense with only a name", () => {
|
||||||
|
const [creature] = normalizePf2eBestiary({
|
||||||
|
creature: [
|
||||||
|
minimalCreature({
|
||||||
|
senses: [{ name: "darkvision" }],
|
||||||
|
}),
|
||||||
|
],
|
||||||
|
});
|
||||||
|
expect(creature.senses).toBe("Darkvision");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("formats sense with name and range but no type", () => {
|
||||||
|
const [creature] = normalizePf2eBestiary({
|
||||||
|
creature: [
|
||||||
|
minimalCreature({
|
||||||
|
senses: [{ name: "scent", range: 60 }],
|
||||||
|
}),
|
||||||
|
],
|
||||||
|
});
|
||||||
|
expect(creature.senses).toBe("Scent 60 feet");
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe("attack traits formatting", () => {
|
||||||
|
it("strips angle-bracket dice notation from traits", () => {
|
||||||
|
const [creature] = normalizePf2eBestiary({
|
||||||
|
creature: [
|
||||||
|
minimalCreature({
|
||||||
|
attacks: [
|
||||||
|
{
|
||||||
|
name: "stinger",
|
||||||
|
range: "Melee",
|
||||||
|
attack: 11,
|
||||||
|
traits: ["deadly <d8>"],
|
||||||
|
damage: "1d6+4 piercing",
|
||||||
|
},
|
||||||
|
],
|
||||||
|
}),
|
||||||
|
],
|
||||||
|
});
|
||||||
|
const attack = creature.attacks?.[0];
|
||||||
|
expect(attack).toBeDefined();
|
||||||
|
expect(attack?.segments[0]).toEqual(
|
||||||
|
expect.objectContaining({
|
||||||
|
type: "text",
|
||||||
|
value: expect.stringContaining("(deadly d8)"),
|
||||||
|
}),
|
||||||
|
);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe("resistances formatting", () => {
|
||||||
|
it("formats resistance without amount", () => {
|
||||||
|
const [creature] = normalizePf2eBestiary({
|
||||||
|
creature: [
|
||||||
|
minimalCreature({
|
||||||
|
defenses: {
|
||||||
|
resistances: [{ name: "physical" }],
|
||||||
|
},
|
||||||
|
}),
|
||||||
|
],
|
||||||
|
});
|
||||||
|
expect(creature.resistances).toBe("Physical");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("formats resistance with amount", () => {
|
||||||
|
const [creature] = normalizePf2eBestiary({
|
||||||
|
creature: [
|
||||||
|
minimalCreature({
|
||||||
|
defenses: {
|
||||||
|
resistances: [{ name: "fire", amount: 10 }],
|
||||||
|
},
|
||||||
|
}),
|
||||||
|
],
|
||||||
|
});
|
||||||
|
expect(creature.resistances).toBe("Fire 10");
|
||||||
|
});
|
||||||
|
});
|
||||||
|
});
|
||||||
@@ -0,0 +1,68 @@
|
|||||||
|
import { describe, expect, it } from "vitest";
|
||||||
|
import {
|
||||||
|
getAllPf2eSourceCodes,
|
||||||
|
getDefaultPf2eFetchUrl,
|
||||||
|
getPf2eSourceDisplayName,
|
||||||
|
loadPf2eBestiaryIndex,
|
||||||
|
} from "../pf2e-bestiary-index-adapter.js";
|
||||||
|
|
||||||
|
describe("loadPf2eBestiaryIndex", () => {
|
||||||
|
it("returns an object with sources and creatures", () => {
|
||||||
|
const index = loadPf2eBestiaryIndex();
|
||||||
|
expect(index.sources).toBeDefined();
|
||||||
|
expect(index.creatures).toBeDefined();
|
||||||
|
expect(Array.isArray(index.creatures)).toBe(true);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("creatures have the expected PF2e shape", () => {
|
||||||
|
const index = loadPf2eBestiaryIndex();
|
||||||
|
expect(index.creatures.length).toBeGreaterThan(0);
|
||||||
|
const first = index.creatures[0];
|
||||||
|
expect(first).toHaveProperty("name");
|
||||||
|
expect(first).toHaveProperty("source");
|
||||||
|
expect(first).toHaveProperty("level");
|
||||||
|
expect(first).toHaveProperty("ac");
|
||||||
|
expect(first).toHaveProperty("hp");
|
||||||
|
expect(first).toHaveProperty("perception");
|
||||||
|
expect(first).toHaveProperty("size");
|
||||||
|
expect(first).toHaveProperty("type");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("contains a substantial number of creatures", () => {
|
||||||
|
const index = loadPf2eBestiaryIndex();
|
||||||
|
expect(index.creatures.length).toBeGreaterThan(2000);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("returns the same cached instance on subsequent calls", () => {
|
||||||
|
const a = loadPf2eBestiaryIndex();
|
||||||
|
const b = loadPf2eBestiaryIndex();
|
||||||
|
expect(a).toBe(b);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe("getAllPf2eSourceCodes", () => {
|
||||||
|
it("returns all keys from the index sources", () => {
|
||||||
|
const codes = getAllPf2eSourceCodes();
|
||||||
|
const index = loadPf2eBestiaryIndex();
|
||||||
|
expect(codes).toEqual(Object.keys(index.sources));
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe("getDefaultPf2eFetchUrl", () => {
|
||||||
|
it("returns Pf2eTools GitHub URL with lowercase source code", () => {
|
||||||
|
const url = getDefaultPf2eFetchUrl("B1");
|
||||||
|
expect(url).toBe(
|
||||||
|
"https://raw.githubusercontent.com/Pf2eToolsOrg/Pf2eTools/dev/data/bestiary/creatures-b1.json",
|
||||||
|
);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe("getPf2eSourceDisplayName", () => {
|
||||||
|
it("returns display name for a known source", () => {
|
||||||
|
expect(getPf2eSourceDisplayName("B1")).toBe("Bestiary");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("falls back to source code for unknown source", () => {
|
||||||
|
expect(getPf2eSourceDisplayName("UNKNOWN")).toBe("UNKNOWN");
|
||||||
|
});
|
||||||
|
});
|
||||||
@@ -5,6 +5,8 @@ import type {
|
|||||||
LegendaryBlock,
|
LegendaryBlock,
|
||||||
SpellcastingBlock,
|
SpellcastingBlock,
|
||||||
TraitBlock,
|
TraitBlock,
|
||||||
|
TraitListItem,
|
||||||
|
TraitSegment,
|
||||||
} from "@initiative/domain";
|
} from "@initiative/domain";
|
||||||
import { creatureId, proficiencyBonus } from "@initiative/domain";
|
import { creatureId, proficiencyBonus } from "@initiative/domain";
|
||||||
import { stripTags } from "./strip-tags.js";
|
import { stripTags } from "./strip-tags.js";
|
||||||
@@ -63,11 +65,18 @@ interface RawEntryObject {
|
|||||||
type: string;
|
type: string;
|
||||||
items?: (
|
items?: (
|
||||||
| string
|
| string
|
||||||
| { type: string; name?: string; entries?: (string | RawEntryObject)[] }
|
| {
|
||||||
|
type: string;
|
||||||
|
name?: string;
|
||||||
|
entry?: string;
|
||||||
|
entries?: (string | RawEntryObject)[];
|
||||||
|
}
|
||||||
)[];
|
)[];
|
||||||
style?: string;
|
style?: string;
|
||||||
name?: string;
|
name?: string;
|
||||||
entries?: (string | RawEntryObject)[];
|
entries?: (string | RawEntryObject)[];
|
||||||
|
colLabels?: string[];
|
||||||
|
rows?: (string | RawEntryObject)[][];
|
||||||
}
|
}
|
||||||
|
|
||||||
interface RawSpellcasting {
|
interface RawSpellcasting {
|
||||||
@@ -257,23 +266,34 @@ function formatConditionImmunities(
|
|||||||
.join(", ");
|
.join(", ");
|
||||||
}
|
}
|
||||||
|
|
||||||
function renderListItem(item: string | RawEntryObject): string | undefined {
|
function toListItem(
|
||||||
|
item:
|
||||||
|
| string
|
||||||
|
| {
|
||||||
|
type: string;
|
||||||
|
name?: string;
|
||||||
|
entry?: string;
|
||||||
|
entries?: (string | RawEntryObject)[];
|
||||||
|
},
|
||||||
|
): TraitListItem | undefined {
|
||||||
if (typeof item === "string") {
|
if (typeof item === "string") {
|
||||||
return `• ${stripTags(item)}`;
|
return { text: stripTags(item) };
|
||||||
}
|
}
|
||||||
if (item.name && item.entries) {
|
if (item.name && item.entries) {
|
||||||
return `• ${stripTags(item.name)}: ${renderEntries(item.entries)}`;
|
return { label: stripTags(item.name), text: renderEntries(item.entries) };
|
||||||
|
}
|
||||||
|
if (item.name && item.entry) {
|
||||||
|
return { label: stripTags(item.name), text: stripTags(item.entry) };
|
||||||
}
|
}
|
||||||
return undefined;
|
return undefined;
|
||||||
}
|
}
|
||||||
|
|
||||||
function renderEntryObject(entry: RawEntryObject, parts: string[]): void {
|
function renderEntryObject(entry: RawEntryObject, parts: string[]): void {
|
||||||
if (entry.type === "list") {
|
if (entry.type === "list" || entry.type === "table") {
|
||||||
for (const item of entry.items ?? []) {
|
// Handled structurally in segmentizeEntries
|
||||||
const rendered = renderListItem(item);
|
return;
|
||||||
if (rendered) parts.push(rendered);
|
|
||||||
}
|
}
|
||||||
} else if (entry.type === "item" && entry.name && entry.entries) {
|
if (entry.type === "item" && entry.name && entry.entries) {
|
||||||
parts.push(`${stripTags(entry.name)}: ${renderEntries(entry.entries)}`);
|
parts.push(`${stripTags(entry.name)}: ${renderEntries(entry.entries)}`);
|
||||||
} else if (entry.entries) {
|
} else if (entry.entries) {
|
||||||
parts.push(renderEntries(entry.entries));
|
parts.push(renderEntries(entry.entries));
|
||||||
@@ -292,11 +312,67 @@ function renderEntries(entries: (string | RawEntryObject)[]): string {
|
|||||||
return parts.join(" ");
|
return parts.join(" ");
|
||||||
}
|
}
|
||||||
|
|
||||||
|
function tableRowToListItem(row: (string | RawEntryObject)[]): TraitListItem {
|
||||||
|
return {
|
||||||
|
label: typeof row[0] === "string" ? stripTags(row[0]) : undefined,
|
||||||
|
text: row
|
||||||
|
.slice(1)
|
||||||
|
.map((cell) =>
|
||||||
|
typeof cell === "string" ? stripTags(cell) : renderEntries([cell]),
|
||||||
|
)
|
||||||
|
.join(" "),
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
function entryToListSegment(entry: RawEntryObject): TraitSegment | undefined {
|
||||||
|
if (entry.type === "list") {
|
||||||
|
const items = (entry.items ?? [])
|
||||||
|
.map(toListItem)
|
||||||
|
.filter((i): i is TraitListItem => i !== undefined);
|
||||||
|
return items.length > 0 ? { type: "list", items } : undefined;
|
||||||
|
}
|
||||||
|
if (entry.type === "table" && entry.rows) {
|
||||||
|
const items = entry.rows.map(tableRowToListItem);
|
||||||
|
return items.length > 0 ? { type: "list", items } : undefined;
|
||||||
|
}
|
||||||
|
return undefined;
|
||||||
|
}
|
||||||
|
|
||||||
|
function segmentizeEntries(
|
||||||
|
entries: (string | RawEntryObject)[],
|
||||||
|
): TraitSegment[] {
|
||||||
|
const segments: TraitSegment[] = [];
|
||||||
|
const textParts: string[] = [];
|
||||||
|
|
||||||
|
const flushText = () => {
|
||||||
|
if (textParts.length > 0) {
|
||||||
|
segments.push({ type: "text", value: textParts.join(" ") });
|
||||||
|
textParts.length = 0;
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
|
for (const entry of entries) {
|
||||||
|
if (typeof entry === "string") {
|
||||||
|
textParts.push(stripTags(entry));
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
const listSeg = entryToListSegment(entry);
|
||||||
|
if (listSeg) {
|
||||||
|
flushText();
|
||||||
|
segments.push(listSeg);
|
||||||
|
} else {
|
||||||
|
renderEntryObject(entry, textParts);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
flushText();
|
||||||
|
return segments;
|
||||||
|
}
|
||||||
|
|
||||||
function normalizeTraits(raw?: RawEntry[]): TraitBlock[] | undefined {
|
function normalizeTraits(raw?: RawEntry[]): TraitBlock[] | undefined {
|
||||||
if (!raw || raw.length === 0) return undefined;
|
if (!raw || raw.length === 0) return undefined;
|
||||||
return raw.map((t) => ({
|
return raw.map((t) => ({
|
||||||
name: stripTags(t.name),
|
name: stripTags(t.name),
|
||||||
text: renderEntries(t.entries),
|
segments: segmentizeEntries(t.entries),
|
||||||
}));
|
}));
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -361,7 +437,7 @@ function normalizeLegendary(
|
|||||||
preamble,
|
preamble,
|
||||||
entries: raw.map((e) => ({
|
entries: raw.map((e) => ({
|
||||||
name: stripTags(e.name),
|
name: stripTags(e.name),
|
||||||
text: renderEntries(e.entries),
|
segments: segmentizeEntries(e.entries),
|
||||||
})),
|
})),
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,23 +1,25 @@
|
|||||||
import type { Creature, CreatureId } from "@initiative/domain";
|
import type { AnyCreature, CreatureId } from "@initiative/domain";
|
||||||
import { type IDBPDatabase, openDB } from "idb";
|
import { type IDBPDatabase, openDB } from "idb";
|
||||||
|
|
||||||
const DB_NAME = "initiative-bestiary";
|
const DB_NAME = "initiative-bestiary";
|
||||||
const STORE_NAME = "sources";
|
const STORE_NAME = "sources";
|
||||||
const DB_VERSION = 2;
|
const DB_VERSION = 4;
|
||||||
|
|
||||||
interface CachedSourceInfo {
|
interface CachedSourceInfo {
|
||||||
readonly sourceCode: string;
|
readonly sourceCode: string;
|
||||||
readonly displayName: string;
|
readonly displayName: string;
|
||||||
readonly creatureCount: number;
|
readonly creatureCount: number;
|
||||||
readonly cachedAt: number;
|
readonly cachedAt: number;
|
||||||
|
readonly system?: string;
|
||||||
}
|
}
|
||||||
|
|
||||||
interface CachedSourceRecord {
|
interface CachedSourceRecord {
|
||||||
sourceCode: string;
|
sourceCode: string;
|
||||||
displayName: string;
|
displayName: string;
|
||||||
creatures: Creature[];
|
creatures: AnyCreature[];
|
||||||
cachedAt: number;
|
cachedAt: number;
|
||||||
creatureCount: number;
|
creatureCount: number;
|
||||||
|
system?: string;
|
||||||
}
|
}
|
||||||
|
|
||||||
let db: IDBPDatabase | null = null;
|
let db: IDBPDatabase | null = null;
|
||||||
@@ -26,6 +28,10 @@ let dbFailed = false;
|
|||||||
// In-memory fallback when IndexedDB is unavailable
|
// In-memory fallback when IndexedDB is unavailable
|
||||||
const memoryStore = new Map<string, CachedSourceRecord>();
|
const memoryStore = new Map<string, CachedSourceRecord>();
|
||||||
|
|
||||||
|
function scopedKey(system: string, sourceCode: string): string {
|
||||||
|
return `${system}:${sourceCode}`;
|
||||||
|
}
|
||||||
|
|
||||||
async function getDb(): Promise<IDBPDatabase | null> {
|
async function getDb(): Promise<IDBPDatabase | null> {
|
||||||
if (db) return db;
|
if (db) return db;
|
||||||
if (dbFailed) return null;
|
if (dbFailed) return null;
|
||||||
@@ -38,8 +44,11 @@ async function getDb(): Promise<IDBPDatabase | null> {
|
|||||||
keyPath: "sourceCode",
|
keyPath: "sourceCode",
|
||||||
});
|
});
|
||||||
}
|
}
|
||||||
if (oldVersion < 2 && database.objectStoreNames.contains(STORE_NAME)) {
|
if (
|
||||||
// Clear cached creatures to pick up improved tag processing
|
oldVersion < DB_VERSION &&
|
||||||
|
database.objectStoreNames.contains(STORE_NAME)
|
||||||
|
) {
|
||||||
|
// Clear cached creatures so they get re-normalized with latest rendering
|
||||||
void transaction.objectStore(STORE_NAME).clear();
|
void transaction.objectStore(STORE_NAME).clear();
|
||||||
}
|
}
|
||||||
},
|
},
|
||||||
@@ -55,60 +64,77 @@ async function getDb(): Promise<IDBPDatabase | null> {
|
|||||||
}
|
}
|
||||||
|
|
||||||
export async function cacheSource(
|
export async function cacheSource(
|
||||||
|
system: string,
|
||||||
sourceCode: string,
|
sourceCode: string,
|
||||||
displayName: string,
|
displayName: string,
|
||||||
creatures: Creature[],
|
creatures: AnyCreature[],
|
||||||
): Promise<void> {
|
): Promise<void> {
|
||||||
|
const key = scopedKey(system, sourceCode);
|
||||||
const record: CachedSourceRecord = {
|
const record: CachedSourceRecord = {
|
||||||
sourceCode,
|
sourceCode: key,
|
||||||
displayName,
|
displayName,
|
||||||
creatures,
|
creatures,
|
||||||
cachedAt: Date.now(),
|
cachedAt: Date.now(),
|
||||||
creatureCount: creatures.length,
|
creatureCount: creatures.length,
|
||||||
|
system,
|
||||||
};
|
};
|
||||||
|
|
||||||
const database = await getDb();
|
const database = await getDb();
|
||||||
if (database) {
|
if (database) {
|
||||||
await database.put(STORE_NAME, record);
|
await database.put(STORE_NAME, record);
|
||||||
} else {
|
} else {
|
||||||
memoryStore.set(sourceCode, record);
|
memoryStore.set(key, record);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
export async function isSourceCached(sourceCode: string): Promise<boolean> {
|
export async function isSourceCached(
|
||||||
|
system: string,
|
||||||
|
sourceCode: string,
|
||||||
|
): Promise<boolean> {
|
||||||
|
const key = scopedKey(system, sourceCode);
|
||||||
const database = await getDb();
|
const database = await getDb();
|
||||||
if (database) {
|
if (database) {
|
||||||
const record = await database.get(STORE_NAME, sourceCode);
|
const record = await database.get(STORE_NAME, key);
|
||||||
return record !== undefined;
|
return record !== undefined;
|
||||||
}
|
}
|
||||||
return memoryStore.has(sourceCode);
|
return memoryStore.has(key);
|
||||||
}
|
}
|
||||||
|
|
||||||
export async function getCachedSources(): Promise<CachedSourceInfo[]> {
|
export async function getCachedSources(
|
||||||
|
system?: string,
|
||||||
|
): Promise<CachedSourceInfo[]> {
|
||||||
const database = await getDb();
|
const database = await getDb();
|
||||||
|
let records: CachedSourceRecord[];
|
||||||
if (database) {
|
if (database) {
|
||||||
const all: CachedSourceRecord[] = await database.getAll(STORE_NAME);
|
records = await database.getAll(STORE_NAME);
|
||||||
return all.map((r) => ({
|
|
||||||
sourceCode: r.sourceCode,
|
|
||||||
displayName: r.displayName,
|
|
||||||
creatureCount: r.creatureCount,
|
|
||||||
cachedAt: r.cachedAt,
|
|
||||||
}));
|
|
||||||
}
|
|
||||||
return [...memoryStore.values()].map((r) => ({
|
|
||||||
sourceCode: r.sourceCode,
|
|
||||||
displayName: r.displayName,
|
|
||||||
creatureCount: r.creatureCount,
|
|
||||||
cachedAt: r.cachedAt,
|
|
||||||
}));
|
|
||||||
}
|
|
||||||
|
|
||||||
export async function clearSource(sourceCode: string): Promise<void> {
|
|
||||||
const database = await getDb();
|
|
||||||
if (database) {
|
|
||||||
await database.delete(STORE_NAME, sourceCode);
|
|
||||||
} else {
|
} else {
|
||||||
memoryStore.delete(sourceCode);
|
records = [...memoryStore.values()];
|
||||||
|
}
|
||||||
|
|
||||||
|
const filtered = system
|
||||||
|
? records.filter((r) => r.system === system)
|
||||||
|
: records;
|
||||||
|
return filtered.map((r) => ({
|
||||||
|
sourceCode: r.system
|
||||||
|
? r.sourceCode.slice(r.system.length + 1)
|
||||||
|
: r.sourceCode,
|
||||||
|
displayName: r.displayName,
|
||||||
|
creatureCount: r.creatureCount,
|
||||||
|
cachedAt: r.cachedAt,
|
||||||
|
system: r.system,
|
||||||
|
}));
|
||||||
|
}
|
||||||
|
|
||||||
|
export async function clearSource(
|
||||||
|
system: string,
|
||||||
|
sourceCode: string,
|
||||||
|
): Promise<void> {
|
||||||
|
const key = scopedKey(system, sourceCode);
|
||||||
|
const database = await getDb();
|
||||||
|
if (database) {
|
||||||
|
await database.delete(STORE_NAME, key);
|
||||||
|
} else {
|
||||||
|
memoryStore.delete(key);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -122,9 +148,9 @@ export async function clearAll(): Promise<void> {
|
|||||||
}
|
}
|
||||||
|
|
||||||
export async function loadAllCachedCreatures(): Promise<
|
export async function loadAllCachedCreatures(): Promise<
|
||||||
Map<CreatureId, Creature>
|
Map<CreatureId, AnyCreature>
|
||||||
> {
|
> {
|
||||||
const map = new Map<CreatureId, Creature>();
|
const map = new Map<CreatureId, AnyCreature>();
|
||||||
const database = await getDb();
|
const database = await getDb();
|
||||||
|
|
||||||
let records: CachedSourceRecord[];
|
let records: CachedSourceRecord[];
|
||||||
|
|||||||
348
apps/web/src/adapters/pf2e-bestiary-adapter.ts
Normal file
348
apps/web/src/adapters/pf2e-bestiary-adapter.ts
Normal file
@@ -0,0 +1,348 @@
|
|||||||
|
import type {
|
||||||
|
CreatureId,
|
||||||
|
Pf2eCreature,
|
||||||
|
TraitBlock,
|
||||||
|
TraitSegment,
|
||||||
|
} from "@initiative/domain";
|
||||||
|
import { creatureId } from "@initiative/domain";
|
||||||
|
import { stripTags } from "./strip-tags.js";
|
||||||
|
|
||||||
|
// -- Raw Pf2eTools types (minimal, for parsing) --
|
||||||
|
|
||||||
|
interface RawPf2eCreature {
|
||||||
|
name: string;
|
||||||
|
source: string;
|
||||||
|
level?: number;
|
||||||
|
traits?: string[];
|
||||||
|
perception?: { std?: number };
|
||||||
|
senses?: { name?: string; type?: string; range?: number }[];
|
||||||
|
languages?: { languages?: string[] };
|
||||||
|
skills?: Record<string, { std?: number }>;
|
||||||
|
abilityMods?: Record<string, number>;
|
||||||
|
items?: string[];
|
||||||
|
defenses?: RawDefenses;
|
||||||
|
speed?: Record<string, number | { number: number }>;
|
||||||
|
attacks?: RawAttack[];
|
||||||
|
abilities?: {
|
||||||
|
top?: RawAbility[];
|
||||||
|
mid?: RawAbility[];
|
||||||
|
bot?: RawAbility[];
|
||||||
|
};
|
||||||
|
_copy?: unknown;
|
||||||
|
}
|
||||||
|
|
||||||
|
interface RawDefenses {
|
||||||
|
ac?: Record<string, unknown>;
|
||||||
|
savingThrows?: {
|
||||||
|
fort?: { std?: number };
|
||||||
|
ref?: { std?: number };
|
||||||
|
will?: { std?: number };
|
||||||
|
};
|
||||||
|
hp?: { hp?: number }[];
|
||||||
|
immunities?: (string | { name: string })[];
|
||||||
|
resistances?: { amount?: number; name: string; note?: string }[];
|
||||||
|
weaknesses?: { amount?: number; name: string; note?: string }[];
|
||||||
|
}
|
||||||
|
|
||||||
|
interface RawAbility {
|
||||||
|
name?: string;
|
||||||
|
entries?: RawEntry[];
|
||||||
|
}
|
||||||
|
|
||||||
|
interface RawAttack {
|
||||||
|
range?: string;
|
||||||
|
name: string;
|
||||||
|
attack?: number;
|
||||||
|
traits?: string[];
|
||||||
|
damage?: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
type RawEntry = string | RawEntryObject;
|
||||||
|
|
||||||
|
interface RawEntryObject {
|
||||||
|
type?: string;
|
||||||
|
items?: (string | { name?: string; entry?: string })[];
|
||||||
|
entries?: RawEntry[];
|
||||||
|
}
|
||||||
|
|
||||||
|
// -- Module state --
|
||||||
|
|
||||||
|
let sourceDisplayNames: Record<string, string> = {};
|
||||||
|
|
||||||
|
export function setPf2eSourceDisplayNames(names: Record<string, string>): void {
|
||||||
|
sourceDisplayNames = names;
|
||||||
|
}
|
||||||
|
|
||||||
|
// -- Helpers --
|
||||||
|
|
||||||
|
function capitalize(s: string): string {
|
||||||
|
return s.charAt(0).toUpperCase() + s.slice(1);
|
||||||
|
}
|
||||||
|
|
||||||
|
function stripDiceBrackets(s: string): string {
|
||||||
|
return s.replaceAll(/<(\d*d\d+)>/g, "$1");
|
||||||
|
}
|
||||||
|
|
||||||
|
function makeCreatureId(source: string, name: string): CreatureId {
|
||||||
|
const slug = name
|
||||||
|
.toLowerCase()
|
||||||
|
.replaceAll(/[^a-z0-9]+/g, "-")
|
||||||
|
.replaceAll(/(^-|-$)/g, "");
|
||||||
|
return creatureId(`${source.toLowerCase()}:${slug}`);
|
||||||
|
}
|
||||||
|
|
||||||
|
function formatSpeed(
|
||||||
|
speed: Record<string, number | { number: number }> | undefined,
|
||||||
|
): string {
|
||||||
|
if (!speed) return "";
|
||||||
|
const parts: string[] = [];
|
||||||
|
for (const [mode, value] of Object.entries(speed)) {
|
||||||
|
if (typeof value === "number") {
|
||||||
|
parts.push(
|
||||||
|
mode === "walk" ? `${value} feet` : `${capitalize(mode)} ${value} feet`,
|
||||||
|
);
|
||||||
|
} else if (typeof value === "object" && "number" in value) {
|
||||||
|
parts.push(
|
||||||
|
mode === "walk"
|
||||||
|
? `${value.number} feet`
|
||||||
|
: `${capitalize(mode)} ${value.number} feet`,
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return parts.join(", ");
|
||||||
|
}
|
||||||
|
|
||||||
|
function formatSkills(
|
||||||
|
skills: Record<string, { std?: number }> | undefined,
|
||||||
|
): string | undefined {
|
||||||
|
if (!skills) return undefined;
|
||||||
|
const parts = Object.entries(skills)
|
||||||
|
.map(([name, val]) => `${capitalize(name)} +${val.std ?? 0}`)
|
||||||
|
.sort();
|
||||||
|
return parts.length > 0 ? parts.join(", ") : undefined;
|
||||||
|
}
|
||||||
|
|
||||||
|
function formatSenses(
|
||||||
|
senses:
|
||||||
|
| readonly { name?: string; type?: string; range?: number }[]
|
||||||
|
| undefined,
|
||||||
|
): string | undefined {
|
||||||
|
if (!senses || senses.length === 0) return undefined;
|
||||||
|
return senses
|
||||||
|
.map((s) => {
|
||||||
|
const label = stripTags(s.name ?? s.type ?? "");
|
||||||
|
if (!label) return "";
|
||||||
|
const parts = [capitalize(label)];
|
||||||
|
if (s.type && s.name) parts.push(`(${s.type})`);
|
||||||
|
if (s.range != null) parts.push(`${s.range} feet`);
|
||||||
|
return parts.join(" ");
|
||||||
|
})
|
||||||
|
.filter(Boolean)
|
||||||
|
.join(", ");
|
||||||
|
}
|
||||||
|
|
||||||
|
function formatLanguages(
|
||||||
|
languages: { languages?: string[] } | undefined,
|
||||||
|
): string | undefined {
|
||||||
|
if (!languages?.languages || languages.languages.length === 0)
|
||||||
|
return undefined;
|
||||||
|
return languages.languages.map(capitalize).join(", ");
|
||||||
|
}
|
||||||
|
|
||||||
|
function formatImmunities(
|
||||||
|
immunities: readonly (string | { name: string })[] | undefined,
|
||||||
|
): string | undefined {
|
||||||
|
if (!immunities || immunities.length === 0) return undefined;
|
||||||
|
return immunities
|
||||||
|
.map((i) => capitalize(typeof i === "string" ? i : i.name))
|
||||||
|
.join(", ");
|
||||||
|
}
|
||||||
|
|
||||||
|
function formatResistances(
|
||||||
|
resistances:
|
||||||
|
| readonly { amount?: number; name: string; note?: string }[]
|
||||||
|
| undefined,
|
||||||
|
): string | undefined {
|
||||||
|
if (!resistances || resistances.length === 0) return undefined;
|
||||||
|
return resistances
|
||||||
|
.map((r) => {
|
||||||
|
const base =
|
||||||
|
r.amount == null
|
||||||
|
? capitalize(r.name)
|
||||||
|
: `${capitalize(r.name)} ${r.amount}`;
|
||||||
|
return r.note ? `${base} (${r.note})` : base;
|
||||||
|
})
|
||||||
|
.join(", ");
|
||||||
|
}
|
||||||
|
|
||||||
|
function formatWeaknesses(
|
||||||
|
weaknesses:
|
||||||
|
| readonly { amount?: number; name: string; note?: string }[]
|
||||||
|
| undefined,
|
||||||
|
): string | undefined {
|
||||||
|
if (!weaknesses || weaknesses.length === 0) return undefined;
|
||||||
|
return weaknesses
|
||||||
|
.map((w) => {
|
||||||
|
const base =
|
||||||
|
w.amount == null
|
||||||
|
? capitalize(w.name)
|
||||||
|
: `${capitalize(w.name)} ${w.amount}`;
|
||||||
|
return w.note ? `${base} (${w.note})` : base;
|
||||||
|
})
|
||||||
|
.join(", ");
|
||||||
|
}
|
||||||
|
|
||||||
|
// -- Entry parsing --
|
||||||
|
|
||||||
|
function segmentizeEntries(entries: unknown): TraitSegment[] {
|
||||||
|
if (!Array.isArray(entries)) return [];
|
||||||
|
const segments: TraitSegment[] = [];
|
||||||
|
for (const entry of entries) {
|
||||||
|
if (typeof entry === "string") {
|
||||||
|
segments.push({ type: "text", value: stripTags(entry) });
|
||||||
|
} else if (typeof entry === "object" && entry !== null) {
|
||||||
|
const obj = entry as RawEntryObject;
|
||||||
|
if (obj.type === "list" && Array.isArray(obj.items)) {
|
||||||
|
segments.push({
|
||||||
|
type: "list",
|
||||||
|
items: obj.items.map((item) => {
|
||||||
|
if (typeof item === "string") {
|
||||||
|
return { text: stripTags(item) };
|
||||||
|
}
|
||||||
|
return { label: item.name, text: stripTags(item.entry ?? "") };
|
||||||
|
}),
|
||||||
|
});
|
||||||
|
} else if (Array.isArray(obj.entries)) {
|
||||||
|
segments.push(...segmentizeEntries(obj.entries));
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return segments;
|
||||||
|
}
|
||||||
|
|
||||||
|
function formatAffliction(a: Record<string, unknown>): TraitSegment[] {
|
||||||
|
const parts: string[] = [];
|
||||||
|
if (a.note) parts.push(stripTags(String(a.note)));
|
||||||
|
if (a.DC) parts.push(`DC ${a.DC}`);
|
||||||
|
if (a.savingThrow) parts.push(String(a.savingThrow));
|
||||||
|
const stages = a.stages as
|
||||||
|
| { stage: number; entry: string; duration: string }[]
|
||||||
|
| undefined;
|
||||||
|
if (stages) {
|
||||||
|
for (const s of stages) {
|
||||||
|
parts.push(`Stage ${s.stage}: ${stripTags(s.entry)} (${s.duration})`);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return parts.length > 0 ? [{ type: "text", value: parts.join("; ") }] : [];
|
||||||
|
}
|
||||||
|
|
||||||
|
function normalizeAbilities(
|
||||||
|
abilities: readonly RawAbility[] | undefined,
|
||||||
|
): TraitBlock[] | undefined {
|
||||||
|
if (!abilities || abilities.length === 0) return undefined;
|
||||||
|
return abilities
|
||||||
|
.filter((a) => a.name)
|
||||||
|
.map((a) => {
|
||||||
|
const raw = a as Record<string, unknown>;
|
||||||
|
return {
|
||||||
|
name: stripTags(a.name as string),
|
||||||
|
segments: Array.isArray(a.entries)
|
||||||
|
? segmentizeEntries(a.entries)
|
||||||
|
: formatAffliction(raw),
|
||||||
|
};
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
function normalizeAttacks(
|
||||||
|
attacks: readonly RawAttack[] | undefined,
|
||||||
|
): TraitBlock[] | undefined {
|
||||||
|
if (!attacks || attacks.length === 0) return undefined;
|
||||||
|
return attacks.map((a) => {
|
||||||
|
const parts: string[] = [];
|
||||||
|
if (a.range) parts.push(a.range);
|
||||||
|
const attackMod = a.attack == null ? "" : ` +${a.attack}`;
|
||||||
|
const traits =
|
||||||
|
a.traits && a.traits.length > 0
|
||||||
|
? ` (${a.traits.map((t) => stripDiceBrackets(stripTags(t))).join(", ")})`
|
||||||
|
: "";
|
||||||
|
const damage = a.damage ? `, ${stripTags(a.damage)}` : "";
|
||||||
|
return {
|
||||||
|
name: capitalize(stripTags(a.name)),
|
||||||
|
segments: [
|
||||||
|
{
|
||||||
|
type: "text" as const,
|
||||||
|
value: `${parts.join(" ")}${attackMod}${traits}${damage}`,
|
||||||
|
},
|
||||||
|
],
|
||||||
|
};
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
// -- Defenses extraction --
|
||||||
|
|
||||||
|
function extractDefenses(defenses: RawDefenses | undefined) {
|
||||||
|
const acRecord = defenses?.ac ?? {};
|
||||||
|
const acStd = (acRecord.std as number | undefined) ?? 0;
|
||||||
|
const acEntries = Object.entries(acRecord).filter(([k]) => k !== "std");
|
||||||
|
return {
|
||||||
|
ac: acStd,
|
||||||
|
acConditional:
|
||||||
|
acEntries.length > 0
|
||||||
|
? acEntries.map(([k, v]) => `${v} ${k}`).join(", ")
|
||||||
|
: undefined,
|
||||||
|
saveFort: defenses?.savingThrows?.fort?.std ?? 0,
|
||||||
|
saveRef: defenses?.savingThrows?.ref?.std ?? 0,
|
||||||
|
saveWill: defenses?.savingThrows?.will?.std ?? 0,
|
||||||
|
hp: defenses?.hp?.[0]?.hp ?? 0,
|
||||||
|
immunities: formatImmunities(defenses?.immunities),
|
||||||
|
resistances: formatResistances(defenses?.resistances),
|
||||||
|
weaknesses: formatWeaknesses(defenses?.weaknesses),
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
// -- Main normalization --
|
||||||
|
|
||||||
|
function normalizeCreature(raw: RawPf2eCreature): Pf2eCreature {
|
||||||
|
const source = raw.source ?? "";
|
||||||
|
const defenses = extractDefenses(raw.defenses);
|
||||||
|
const mods = raw.abilityMods ?? {};
|
||||||
|
|
||||||
|
return {
|
||||||
|
system: "pf2e",
|
||||||
|
id: makeCreatureId(source, raw.name),
|
||||||
|
name: raw.name,
|
||||||
|
source,
|
||||||
|
sourceDisplayName: sourceDisplayNames[source] ?? source,
|
||||||
|
level: raw.level ?? 0,
|
||||||
|
traits: raw.traits ?? [],
|
||||||
|
perception: raw.perception?.std ?? 0,
|
||||||
|
senses: formatSenses(raw.senses),
|
||||||
|
languages: formatLanguages(raw.languages),
|
||||||
|
skills: formatSkills(raw.skills),
|
||||||
|
abilityMods: {
|
||||||
|
str: mods.str ?? 0,
|
||||||
|
dex: mods.dex ?? 0,
|
||||||
|
con: mods.con ?? 0,
|
||||||
|
int: mods.int ?? 0,
|
||||||
|
wis: mods.wis ?? 0,
|
||||||
|
cha: mods.cha ?? 0,
|
||||||
|
},
|
||||||
|
...defenses,
|
||||||
|
speed: formatSpeed(raw.speed),
|
||||||
|
attacks: normalizeAttacks(raw.attacks),
|
||||||
|
abilitiesTop: normalizeAbilities(raw.abilities?.top),
|
||||||
|
abilitiesMid: normalizeAbilities(raw.abilities?.mid),
|
||||||
|
abilitiesBot: normalizeAbilities(raw.abilities?.bot),
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
export function normalizePf2eBestiary(raw: {
|
||||||
|
creature: unknown[];
|
||||||
|
}): Pf2eCreature[] {
|
||||||
|
return (raw.creature ?? [])
|
||||||
|
.filter((c: unknown) => {
|
||||||
|
const obj = c as { _copy?: unknown };
|
||||||
|
return !obj._copy;
|
||||||
|
})
|
||||||
|
.map((c) => normalizeCreature(c as RawPf2eCreature));
|
||||||
|
}
|
||||||
70
apps/web/src/adapters/pf2e-bestiary-index-adapter.ts
Normal file
70
apps/web/src/adapters/pf2e-bestiary-index-adapter.ts
Normal file
@@ -0,0 +1,70 @@
|
|||||||
|
import type {
|
||||||
|
Pf2eBestiaryIndex,
|
||||||
|
Pf2eBestiaryIndexEntry,
|
||||||
|
} from "@initiative/domain";
|
||||||
|
|
||||||
|
import rawIndex from "../../../../data/bestiary/pf2e-index.json";
|
||||||
|
|
||||||
|
interface CompactCreature {
|
||||||
|
readonly n: string;
|
||||||
|
readonly s: string;
|
||||||
|
readonly lv: number;
|
||||||
|
readonly ac: number;
|
||||||
|
readonly hp: number;
|
||||||
|
readonly pc: number;
|
||||||
|
readonly sz: string;
|
||||||
|
readonly tp: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
interface CompactIndex {
|
||||||
|
readonly sources: Record<string, string>;
|
||||||
|
readonly creatures: readonly CompactCreature[];
|
||||||
|
}
|
||||||
|
|
||||||
|
function mapCreature(c: CompactCreature): Pf2eBestiaryIndexEntry {
|
||||||
|
return {
|
||||||
|
name: c.n,
|
||||||
|
source: c.s,
|
||||||
|
level: c.lv,
|
||||||
|
ac: c.ac,
|
||||||
|
hp: c.hp,
|
||||||
|
perception: c.pc,
|
||||||
|
size: c.sz,
|
||||||
|
type: c.tp,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
let cachedIndex: Pf2eBestiaryIndex | undefined;
|
||||||
|
|
||||||
|
export function loadPf2eBestiaryIndex(): Pf2eBestiaryIndex {
|
||||||
|
if (cachedIndex) return cachedIndex;
|
||||||
|
|
||||||
|
const compact = rawIndex as unknown as CompactIndex;
|
||||||
|
cachedIndex = {
|
||||||
|
sources: compact.sources,
|
||||||
|
creatures: compact.creatures.map(mapCreature),
|
||||||
|
};
|
||||||
|
return cachedIndex;
|
||||||
|
}
|
||||||
|
|
||||||
|
export function getAllPf2eSourceCodes(): string[] {
|
||||||
|
const index = loadPf2eBestiaryIndex();
|
||||||
|
return Object.keys(index.sources);
|
||||||
|
}
|
||||||
|
|
||||||
|
export function getDefaultPf2eFetchUrl(
|
||||||
|
sourceCode: string,
|
||||||
|
baseUrl?: string,
|
||||||
|
): string {
|
||||||
|
const filename = `creatures-${sourceCode.toLowerCase()}.json`;
|
||||||
|
if (baseUrl !== undefined) {
|
||||||
|
const normalized = baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
|
||||||
|
return `${normalized}${filename}`;
|
||||||
|
}
|
||||||
|
return `https://raw.githubusercontent.com/Pf2eToolsOrg/Pf2eTools/dev/data/bestiary/${filename}`;
|
||||||
|
}
|
||||||
|
|
||||||
|
export function getPf2eSourceDisplayName(sourceCode: string): string {
|
||||||
|
const index = loadPf2eBestiaryIndex();
|
||||||
|
return index.sources[sourceCode] ?? sourceCode;
|
||||||
|
}
|
||||||
@@ -1,8 +1,9 @@
|
|||||||
import type {
|
import type {
|
||||||
|
AnyCreature,
|
||||||
BestiaryIndex,
|
BestiaryIndex,
|
||||||
Creature,
|
|
||||||
CreatureId,
|
CreatureId,
|
||||||
Encounter,
|
Encounter,
|
||||||
|
Pf2eBestiaryIndex,
|
||||||
PlayerCharacter,
|
PlayerCharacter,
|
||||||
UndoRedoState,
|
UndoRedoState,
|
||||||
} from "@initiative/domain";
|
} from "@initiative/domain";
|
||||||
@@ -31,15 +32,16 @@ export interface CachedSourceInfo {
|
|||||||
|
|
||||||
export interface BestiaryCachePort {
|
export interface BestiaryCachePort {
|
||||||
cacheSource(
|
cacheSource(
|
||||||
|
system: string,
|
||||||
sourceCode: string,
|
sourceCode: string,
|
||||||
displayName: string,
|
displayName: string,
|
||||||
creatures: Creature[],
|
creatures: AnyCreature[],
|
||||||
): Promise<void>;
|
): Promise<void>;
|
||||||
isSourceCached(sourceCode: string): Promise<boolean>;
|
isSourceCached(system: string, sourceCode: string): Promise<boolean>;
|
||||||
getCachedSources(): Promise<CachedSourceInfo[]>;
|
getCachedSources(system?: string): Promise<CachedSourceInfo[]>;
|
||||||
clearSource(sourceCode: string): Promise<void>;
|
clearSource(system: string, sourceCode: string): Promise<void>;
|
||||||
clearAll(): Promise<void>;
|
clearAll(): Promise<void>;
|
||||||
loadAllCachedCreatures(): Promise<Map<CreatureId, Creature>>;
|
loadAllCachedCreatures(): Promise<Map<CreatureId, AnyCreature>>;
|
||||||
}
|
}
|
||||||
|
|
||||||
export interface BestiaryIndexPort {
|
export interface BestiaryIndexPort {
|
||||||
@@ -48,3 +50,10 @@ export interface BestiaryIndexPort {
|
|||||||
getDefaultFetchUrl(sourceCode: string, baseUrl?: string): string;
|
getDefaultFetchUrl(sourceCode: string, baseUrl?: string): string;
|
||||||
getSourceDisplayName(sourceCode: string): string;
|
getSourceDisplayName(sourceCode: string): string;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
export interface Pf2eBestiaryIndexPort {
|
||||||
|
loadIndex(): Pf2eBestiaryIndex;
|
||||||
|
getAllSourceCodes(): string[];
|
||||||
|
getDefaultFetchUrl(sourceCode: string, baseUrl?: string): string;
|
||||||
|
getSourceDisplayName(sourceCode: string): string;
|
||||||
|
}
|
||||||
|
|||||||
@@ -13,6 +13,7 @@ import {
|
|||||||
} from "../persistence/undo-redo-storage.js";
|
} from "../persistence/undo-redo-storage.js";
|
||||||
import * as bestiaryCache from "./bestiary-cache.js";
|
import * as bestiaryCache from "./bestiary-cache.js";
|
||||||
import * as bestiaryIndex from "./bestiary-index-adapter.js";
|
import * as bestiaryIndex from "./bestiary-index-adapter.js";
|
||||||
|
import * as pf2eBestiaryIndex from "./pf2e-bestiary-index-adapter.js";
|
||||||
|
|
||||||
export const productionAdapters: Adapters = {
|
export const productionAdapters: Adapters = {
|
||||||
encounterPersistence: {
|
encounterPersistence: {
|
||||||
@@ -41,4 +42,10 @@ export const productionAdapters: Adapters = {
|
|||||||
getDefaultFetchUrl: bestiaryIndex.getDefaultFetchUrl,
|
getDefaultFetchUrl: bestiaryIndex.getDefaultFetchUrl,
|
||||||
getSourceDisplayName: bestiaryIndex.getSourceDisplayName,
|
getSourceDisplayName: bestiaryIndex.getSourceDisplayName,
|
||||||
},
|
},
|
||||||
|
pf2eBestiaryIndex: {
|
||||||
|
loadIndex: pf2eBestiaryIndex.loadPf2eBestiaryIndex,
|
||||||
|
getAllSourceCodes: pf2eBestiaryIndex.getAllPf2eSourceCodes,
|
||||||
|
getDefaultFetchUrl: pf2eBestiaryIndex.getDefaultPf2eFetchUrl,
|
||||||
|
getSourceDisplayName: pf2eBestiaryIndex.getPf2eSourceDisplayName,
|
||||||
|
},
|
||||||
};
|
};
|
||||||
|
|||||||
@@ -6,6 +6,7 @@ import userEvent from "@testing-library/user-event";
|
|||||||
import { afterEach, describe, expect, it, vi } from "vitest";
|
import { afterEach, describe, expect, it, vi } from "vitest";
|
||||||
import { createTestAdapters } from "../../__tests__/adapters/in-memory-adapters.js";
|
import { createTestAdapters } from "../../__tests__/adapters/in-memory-adapters.js";
|
||||||
import { AdapterProvider } from "../../contexts/adapter-context.js";
|
import { AdapterProvider } from "../../contexts/adapter-context.js";
|
||||||
|
import { RulesEditionProvider } from "../../contexts/rules-edition-context.js";
|
||||||
import { BulkImportPrompt } from "../bulk-import-prompt.js";
|
import { BulkImportPrompt } from "../bulk-import-prompt.js";
|
||||||
|
|
||||||
const THREE_SOURCES_REGEX = /3 sources/;
|
const THREE_SOURCES_REGEX = /3 sources/;
|
||||||
@@ -68,9 +69,11 @@ function createAdaptersWithSources() {
|
|||||||
function renderWithAdapters() {
|
function renderWithAdapters() {
|
||||||
const adapters = createAdaptersWithSources();
|
const adapters = createAdaptersWithSources();
|
||||||
return render(
|
return render(
|
||||||
|
<RulesEditionProvider>
|
||||||
<AdapterProvider adapters={adapters}>
|
<AdapterProvider adapters={adapters}>
|
||||||
<BulkImportPrompt />
|
<BulkImportPrompt />
|
||||||
</AdapterProvider>,
|
</AdapterProvider>
|
||||||
|
</RulesEditionProvider>,
|
||||||
);
|
);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -1,7 +1,11 @@
|
|||||||
// @vitest-environment jsdom
|
// @vitest-environment jsdom
|
||||||
import "@testing-library/jest-dom/vitest";
|
import "@testing-library/jest-dom/vitest";
|
||||||
|
|
||||||
import { CONDITION_DEFINITIONS, type ConditionId } from "@initiative/domain";
|
import {
|
||||||
|
type ConditionEntry,
|
||||||
|
type ConditionId,
|
||||||
|
getConditionsForEdition,
|
||||||
|
} from "@initiative/domain";
|
||||||
import { cleanup, render, screen } from "@testing-library/react";
|
import { cleanup, render, screen } from "@testing-library/react";
|
||||||
import userEvent from "@testing-library/user-event";
|
import userEvent from "@testing-library/user-event";
|
||||||
import { createRef, type RefObject } from "react";
|
import { createRef, type RefObject } from "react";
|
||||||
@@ -13,12 +17,14 @@ afterEach(cleanup);
|
|||||||
|
|
||||||
function renderPicker(
|
function renderPicker(
|
||||||
overrides: Partial<{
|
overrides: Partial<{
|
||||||
activeConditions: readonly ConditionId[];
|
activeConditions: readonly ConditionEntry[];
|
||||||
onToggle: (conditionId: ConditionId) => void;
|
onToggle: (conditionId: ConditionId) => void;
|
||||||
|
onSetValue: (conditionId: ConditionId, value: number) => void;
|
||||||
onClose: () => void;
|
onClose: () => void;
|
||||||
}> = {},
|
}> = {},
|
||||||
) {
|
) {
|
||||||
const onToggle = overrides.onToggle ?? vi.fn();
|
const onToggle = overrides.onToggle ?? vi.fn();
|
||||||
|
const onSetValue = overrides.onSetValue ?? vi.fn();
|
||||||
const onClose = overrides.onClose ?? vi.fn();
|
const onClose = overrides.onClose ?? vi.fn();
|
||||||
const anchorRef = createRef<HTMLElement>() as RefObject<HTMLElement>;
|
const anchorRef = createRef<HTMLElement>() as RefObject<HTMLElement>;
|
||||||
const anchor = document.createElement("div");
|
const anchor = document.createElement("div");
|
||||||
@@ -30,25 +36,27 @@ function renderPicker(
|
|||||||
anchorRef={anchorRef}
|
anchorRef={anchorRef}
|
||||||
activeConditions={overrides.activeConditions ?? []}
|
activeConditions={overrides.activeConditions ?? []}
|
||||||
onToggle={onToggle}
|
onToggle={onToggle}
|
||||||
|
onSetValue={onSetValue}
|
||||||
onClose={onClose}
|
onClose={onClose}
|
||||||
/>
|
/>
|
||||||
</RulesEditionProvider>,
|
</RulesEditionProvider>,
|
||||||
);
|
);
|
||||||
return { ...result, onToggle, onClose };
|
return { ...result, onToggle, onSetValue, onClose };
|
||||||
}
|
}
|
||||||
|
|
||||||
describe("ConditionPicker", () => {
|
describe("ConditionPicker", () => {
|
||||||
it("renders all condition definitions from domain", () => {
|
it("renders edition-specific conditions from domain", () => {
|
||||||
renderPicker();
|
renderPicker();
|
||||||
for (const def of CONDITION_DEFINITIONS) {
|
const editionConditions = getConditionsForEdition("5.5e");
|
||||||
|
for (const def of editionConditions) {
|
||||||
expect(screen.getByText(def.label)).toBeInTheDocument();
|
expect(screen.getByText(def.label)).toBeInTheDocument();
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
|
|
||||||
it("active conditions are visually distinguished", () => {
|
it("active conditions are visually distinguished", () => {
|
||||||
renderPicker({ activeConditions: ["blinded"] });
|
renderPicker({ activeConditions: [{ id: "blinded" }] });
|
||||||
const blindedButton = screen.getByText("Blinded").closest("button");
|
const row = screen.getByText("Blinded").closest("div[class]");
|
||||||
expect(blindedButton?.className).toContain("bg-card/50");
|
expect(row?.className).toContain("bg-card/50");
|
||||||
});
|
});
|
||||||
|
|
||||||
it("clicking a condition calls onToggle with that condition's ID", async () => {
|
it("clicking a condition calls onToggle with that condition's ID", async () => {
|
||||||
@@ -65,7 +73,7 @@ describe("ConditionPicker", () => {
|
|||||||
});
|
});
|
||||||
|
|
||||||
it("active condition labels use foreground color", () => {
|
it("active condition labels use foreground color", () => {
|
||||||
renderPicker({ activeConditions: ["charmed"] });
|
renderPicker({ activeConditions: [{ id: "charmed" }] });
|
||||||
const label = screen.getByText("Charmed");
|
const label = screen.getByText("Charmed");
|
||||||
expect(label.className).toContain("text-foreground");
|
expect(label.className).toContain("text-foreground");
|
||||||
});
|
});
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
// @vitest-environment jsdom
|
// @vitest-environment jsdom
|
||||||
import type { ConditionId } from "@initiative/domain";
|
import type { ConditionEntry } from "@initiative/domain";
|
||||||
import { cleanup, render, screen } from "@testing-library/react";
|
import { cleanup, render, screen } from "@testing-library/react";
|
||||||
import { userEvent } from "@testing-library/user-event";
|
import { userEvent } from "@testing-library/user-event";
|
||||||
import { afterEach, describe, expect, it, vi } from "vitest";
|
import { afterEach, describe, expect, it, vi } from "vitest";
|
||||||
@@ -14,6 +14,7 @@ function renderTags(props: Partial<Parameters<typeof ConditionTags>[0]> = {}) {
|
|||||||
<ConditionTags
|
<ConditionTags
|
||||||
conditions={props.conditions}
|
conditions={props.conditions}
|
||||||
onRemove={props.onRemove ?? (() => {})}
|
onRemove={props.onRemove ?? (() => {})}
|
||||||
|
onDecrement={props.onDecrement ?? (() => {})}
|
||||||
onOpenPicker={props.onOpenPicker ?? (() => {})}
|
onOpenPicker={props.onOpenPicker ?? (() => {})}
|
||||||
/>
|
/>
|
||||||
</RulesEditionProvider>,
|
</RulesEditionProvider>,
|
||||||
@@ -28,7 +29,7 @@ describe("ConditionTags", () => {
|
|||||||
});
|
});
|
||||||
|
|
||||||
it("renders a button per condition", () => {
|
it("renders a button per condition", () => {
|
||||||
const conditions: ConditionId[] = ["blinded", "prone"];
|
const conditions: ConditionEntry[] = [{ id: "blinded" }, { id: "prone" }];
|
||||||
renderTags({ conditions });
|
renderTags({ conditions });
|
||||||
expect(
|
expect(
|
||||||
screen.getByRole("button", { name: "Remove Blinded" }),
|
screen.getByRole("button", { name: "Remove Blinded" }),
|
||||||
@@ -39,7 +40,7 @@ describe("ConditionTags", () => {
|
|||||||
it("calls onRemove with condition id when clicked", async () => {
|
it("calls onRemove with condition id when clicked", async () => {
|
||||||
const onRemove = vi.fn();
|
const onRemove = vi.fn();
|
||||||
renderTags({
|
renderTags({
|
||||||
conditions: ["blinded"] as ConditionId[],
|
conditions: [{ id: "blinded" }] as ConditionEntry[],
|
||||||
onRemove,
|
onRemove,
|
||||||
});
|
});
|
||||||
|
|
||||||
@@ -66,4 +67,37 @@ describe("ConditionTags", () => {
|
|||||||
// Only add button
|
// Only add button
|
||||||
expect(screen.getByRole("button", { name: "Add condition" })).toBeDefined();
|
expect(screen.getByRole("button", { name: "Add condition" })).toBeDefined();
|
||||||
});
|
});
|
||||||
|
|
||||||
|
it("displays value badge for valued conditions", () => {
|
||||||
|
renderTags({ conditions: [{ id: "frightened", value: 3 }] });
|
||||||
|
expect(screen.getByText("3")).toBeDefined();
|
||||||
|
});
|
||||||
|
|
||||||
|
it("calls onDecrement for valued condition click", async () => {
|
||||||
|
const onDecrement = vi.fn();
|
||||||
|
renderTags({
|
||||||
|
conditions: [{ id: "frightened", value: 2 }],
|
||||||
|
onDecrement,
|
||||||
|
});
|
||||||
|
|
||||||
|
await userEvent.click(
|
||||||
|
screen.getByRole("button", { name: "Remove Frightened" }),
|
||||||
|
);
|
||||||
|
|
||||||
|
expect(onDecrement).toHaveBeenCalledWith("frightened");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("calls onRemove for non-valued condition click", async () => {
|
||||||
|
const onRemove = vi.fn();
|
||||||
|
renderTags({
|
||||||
|
conditions: [{ id: "blinded" }],
|
||||||
|
onRemove,
|
||||||
|
});
|
||||||
|
|
||||||
|
await userEvent.click(
|
||||||
|
screen.getByRole("button", { name: "Remove Blinded" }),
|
||||||
|
);
|
||||||
|
|
||||||
|
expect(onRemove).toHaveBeenCalledWith("blinded");
|
||||||
|
});
|
||||||
});
|
});
|
||||||
|
|||||||
@@ -3,7 +3,13 @@ import "@testing-library/jest-dom/vitest";
|
|||||||
|
|
||||||
import type { Creature, CreatureId, PlayerCharacter } from "@initiative/domain";
|
import type { Creature, CreatureId, PlayerCharacter } from "@initiative/domain";
|
||||||
import { combatantId, creatureId, playerCharacterId } from "@initiative/domain";
|
import { combatantId, creatureId, playerCharacterId } from "@initiative/domain";
|
||||||
import { cleanup, render, screen, waitFor } from "@testing-library/react";
|
import {
|
||||||
|
cleanup,
|
||||||
|
render,
|
||||||
|
renderHook,
|
||||||
|
screen,
|
||||||
|
waitFor,
|
||||||
|
} from "@testing-library/react";
|
||||||
import userEvent from "@testing-library/user-event";
|
import userEvent from "@testing-library/user-event";
|
||||||
import { afterEach, beforeAll, describe, expect, it, vi } from "vitest";
|
import { afterEach, beforeAll, describe, expect, it, vi } from "vitest";
|
||||||
import { createTestAdapters } from "../../__tests__/adapters/in-memory-adapters.js";
|
import { createTestAdapters } from "../../__tests__/adapters/in-memory-adapters.js";
|
||||||
@@ -13,6 +19,7 @@ import {
|
|||||||
buildEncounter,
|
buildEncounter,
|
||||||
} from "../../__tests__/factories/index.js";
|
} from "../../__tests__/factories/index.js";
|
||||||
import { AllProviders } from "../../__tests__/test-providers.js";
|
import { AllProviders } from "../../__tests__/test-providers.js";
|
||||||
|
import { useRulesEdition } from "../../hooks/use-rules-edition.js";
|
||||||
import { DifficultyBreakdownPanel } from "../difficulty-breakdown-panel.js";
|
import { DifficultyBreakdownPanel } from "../difficulty-breakdown-panel.js";
|
||||||
|
|
||||||
beforeAll(() => {
|
beforeAll(() => {
|
||||||
@@ -121,7 +128,7 @@ describe("DifficultyBreakdownPanel", () => {
|
|||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
it("renders bestiary combatant as read-only with source name", async () => {
|
it("shows PC in party column with level", async () => {
|
||||||
renderPanel({
|
renderPanel({
|
||||||
encounter: defaultEncounter(),
|
encounter: defaultEncounter(),
|
||||||
playerCharacters: defaultPCs,
|
playerCharacters: defaultPCs,
|
||||||
@@ -129,12 +136,53 @@ describe("DifficultyBreakdownPanel", () => {
|
|||||||
});
|
});
|
||||||
|
|
||||||
await waitFor(() => {
|
await waitFor(() => {
|
||||||
expect(screen.getByText("Goblin (SRD)")).toBeInTheDocument();
|
expect(screen.getByText("Hero")).toBeInTheDocument();
|
||||||
|
expect(screen.getByText("Lv 5")).toBeInTheDocument();
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
it("shows monsters in enemy column", async () => {
|
||||||
|
renderPanel({
|
||||||
|
encounter: defaultEncounter(),
|
||||||
|
playerCharacters: defaultPCs,
|
||||||
|
creatures: new Map([[goblinCreature.id, goblinCreature]]),
|
||||||
|
});
|
||||||
|
|
||||||
|
await waitFor(() => {
|
||||||
|
expect(screen.getByText("Goblin")).toBeInTheDocument();
|
||||||
expect(screen.getAllByText("CR 1/4").length).toBeGreaterThanOrEqual(1);
|
expect(screen.getAllByText("CR 1/4").length).toBeGreaterThanOrEqual(1);
|
||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
it("renders custom combatant with CR picker", async () => {
|
it("renders explanation text", async () => {
|
||||||
|
renderPanel({
|
||||||
|
encounter: defaultEncounter(),
|
||||||
|
playerCharacters: defaultPCs,
|
||||||
|
creatures: new Map([[goblinCreature.id, goblinCreature]]),
|
||||||
|
});
|
||||||
|
|
||||||
|
await waitFor(() => {
|
||||||
|
expect(
|
||||||
|
screen.getByText(
|
||||||
|
"Allied NPC XP is subtracted from encounter difficulty",
|
||||||
|
),
|
||||||
|
).toBeInTheDocument();
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
it("renders Net Monster XP footer", async () => {
|
||||||
|
renderPanel({
|
||||||
|
encounter: defaultEncounter(),
|
||||||
|
playerCharacters: defaultPCs,
|
||||||
|
creatures: new Map([[goblinCreature.id, goblinCreature]]),
|
||||||
|
});
|
||||||
|
|
||||||
|
await waitFor(() => {
|
||||||
|
expect(screen.getByText("Net Monster XP")).toBeInTheDocument();
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
it("renders custom combatant with CR picker in enemy column", async () => {
|
||||||
renderPanel({
|
renderPanel({
|
||||||
encounter: defaultEncounter(),
|
encounter: defaultEncounter(),
|
||||||
playerCharacters: defaultPCs,
|
playerCharacters: defaultPCs,
|
||||||
@@ -144,27 +192,10 @@ describe("DifficultyBreakdownPanel", () => {
|
|||||||
await waitFor(() => {
|
await waitFor(() => {
|
||||||
const pickers = screen.getAllByLabelText("Challenge rating");
|
const pickers = screen.getAllByLabelText("Challenge rating");
|
||||||
expect(pickers).toHaveLength(2);
|
expect(pickers).toHaveLength(2);
|
||||||
// First picker is "Custom Thug" with CR 2
|
|
||||||
expect(pickers[0]).toHaveValue("2");
|
expect(pickers[0]).toHaveValue("2");
|
||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
it("renders unassigned combatant with Assign picker and dash for XP", async () => {
|
|
||||||
renderPanel({
|
|
||||||
encounter: defaultEncounter(),
|
|
||||||
playerCharacters: defaultPCs,
|
|
||||||
creatures: new Map([[goblinCreature.id, goblinCreature]]),
|
|
||||||
});
|
|
||||||
|
|
||||||
await waitFor(() => {
|
|
||||||
const pickers = screen.getAllByLabelText("Challenge rating");
|
|
||||||
// Second picker is "Bandit" with no CR
|
|
||||||
expect(pickers[1]).toHaveValue("");
|
|
||||||
// "—" appears for unassigned XP
|
|
||||||
expect(screen.getByText("—")).toBeInTheDocument();
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
it("selecting a CR updates the visible XP value", async () => {
|
it("selecting a CR updates the visible XP value", async () => {
|
||||||
const user = userEvent.setup();
|
const user = userEvent.setup();
|
||||||
renderPanel({
|
renderPanel({
|
||||||
@@ -173,24 +204,19 @@ describe("DifficultyBreakdownPanel", () => {
|
|||||||
creatures: new Map([[goblinCreature.id, goblinCreature]]),
|
creatures: new Map([[goblinCreature.id, goblinCreature]]),
|
||||||
});
|
});
|
||||||
|
|
||||||
// Wait for the panel to render with bestiary data
|
|
||||||
await waitFor(() => {
|
await waitFor(() => {
|
||||||
expect(screen.getByText("—")).toBeInTheDocument();
|
expect(screen.getAllByLabelText("Challenge rating")).toHaveLength(2);
|
||||||
});
|
});
|
||||||
|
|
||||||
// The Bandit (second picker) has no CR — shows "—" for XP
|
|
||||||
const pickers = screen.getAllByLabelText("Challenge rating");
|
const pickers = screen.getAllByLabelText("Challenge rating");
|
||||||
|
|
||||||
// Select CR 5 (1,800 XP) on Bandit
|
|
||||||
await user.selectOptions(pickers[1], "5");
|
await user.selectOptions(pickers[1], "5");
|
||||||
|
|
||||||
// XP should update — the "—" should be replaced with an XP value
|
|
||||||
await waitFor(() => {
|
await waitFor(() => {
|
||||||
expect(screen.getByText("1,800")).toBeInTheDocument();
|
expect(screen.getByText("1,800")).toBeInTheDocument();
|
||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
it("renders total monster XP", async () => {
|
it("non-PC combatants show toggle button", async () => {
|
||||||
renderPanel({
|
renderPanel({
|
||||||
encounter: defaultEncounter(),
|
encounter: defaultEncounter(),
|
||||||
playerCharacters: defaultPCs,
|
playerCharacters: defaultPCs,
|
||||||
@@ -198,12 +224,57 @@ describe("DifficultyBreakdownPanel", () => {
|
|||||||
});
|
});
|
||||||
|
|
||||||
await waitFor(() => {
|
await waitFor(() => {
|
||||||
expect(screen.getByText("Total Monster XP")).toBeInTheDocument();
|
// Each non-PC enemy combatant has a toggle button
|
||||||
|
expect(
|
||||||
|
screen.getByLabelText("Move Goblin to party side"),
|
||||||
|
).toBeInTheDocument();
|
||||||
|
expect(
|
||||||
|
screen.getByLabelText("Move Custom Thug to party side"),
|
||||||
|
).toBeInTheDocument();
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
it("PC combatants do not show side toggle", async () => {
|
||||||
|
renderPanel({
|
||||||
|
encounter: defaultEncounter(),
|
||||||
|
playerCharacters: defaultPCs,
|
||||||
|
creatures: new Map([[goblinCreature.id, goblinCreature]]),
|
||||||
|
});
|
||||||
|
|
||||||
|
await waitFor(() => {
|
||||||
|
expect(screen.getByText("Hero")).toBeInTheDocument();
|
||||||
|
});
|
||||||
|
|
||||||
|
expect(
|
||||||
|
screen.queryByLabelText("Move Hero to enemy side"),
|
||||||
|
).not.toBeInTheDocument();
|
||||||
|
});
|
||||||
|
|
||||||
|
it("side toggle moves combatant between sections", async () => {
|
||||||
|
const user = userEvent.setup();
|
||||||
|
renderPanel({
|
||||||
|
encounter: defaultEncounter(),
|
||||||
|
playerCharacters: defaultPCs,
|
||||||
|
creatures: new Map([[goblinCreature.id, goblinCreature]]),
|
||||||
|
});
|
||||||
|
|
||||||
|
await waitFor(() => {
|
||||||
|
expect(screen.getByText("Goblin")).toBeInTheDocument();
|
||||||
|
});
|
||||||
|
|
||||||
|
// Toggle goblin to party side
|
||||||
|
const toggleBtn = screen.getByLabelText("Move Goblin to party side");
|
||||||
|
await user.click(toggleBtn);
|
||||||
|
|
||||||
|
// After toggle, the aria-label should change to "Move Goblin to enemy side"
|
||||||
|
await waitFor(() => {
|
||||||
|
expect(
|
||||||
|
screen.getByLabelText("Move Goblin to enemy side"),
|
||||||
|
).toBeInTheDocument();
|
||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
it("renders nothing when breakdown data is insufficient", () => {
|
it("renders nothing when breakdown data is insufficient", () => {
|
||||||
// No PCs with level → breakdown returns null
|
|
||||||
const { container } = renderPanel({
|
const { container } = renderPanel({
|
||||||
encounter: buildEncounter({
|
encounter: buildEncounter({
|
||||||
combatants: [
|
combatants: [
|
||||||
@@ -215,6 +286,63 @@ describe("DifficultyBreakdownPanel", () => {
|
|||||||
expect(container.innerHTML).toBe("");
|
expect(container.innerHTML).toBe("");
|
||||||
});
|
});
|
||||||
|
|
||||||
|
it("shows 4 threshold columns for 2014 edition", async () => {
|
||||||
|
const { result: editionResult } = renderHook(() => useRulesEdition());
|
||||||
|
editionResult.current.setEdition("5e");
|
||||||
|
|
||||||
|
try {
|
||||||
|
renderPanel({
|
||||||
|
encounter: defaultEncounter(),
|
||||||
|
playerCharacters: defaultPCs,
|
||||||
|
creatures: new Map([[goblinCreature.id, goblinCreature]]),
|
||||||
|
});
|
||||||
|
|
||||||
|
await waitFor(() => {
|
||||||
|
expect(screen.getByText("Easy:", { exact: false })).toBeInTheDocument();
|
||||||
|
expect(screen.getByText("Med:", { exact: false })).toBeInTheDocument();
|
||||||
|
expect(screen.getByText("Hard:", { exact: false })).toBeInTheDocument();
|
||||||
|
expect(
|
||||||
|
screen.getByText("Deadly:", { exact: false }),
|
||||||
|
).toBeInTheDocument();
|
||||||
|
});
|
||||||
|
} finally {
|
||||||
|
editionResult.current.setEdition("5.5e");
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
it("shows multiplier and adjusted XP for 2014 edition", async () => {
|
||||||
|
const { result: editionResult } = renderHook(() => useRulesEdition());
|
||||||
|
editionResult.current.setEdition("5e");
|
||||||
|
|
||||||
|
try {
|
||||||
|
renderPanel({
|
||||||
|
encounter: defaultEncounter(),
|
||||||
|
playerCharacters: defaultPCs,
|
||||||
|
creatures: new Map([[goblinCreature.id, goblinCreature]]),
|
||||||
|
});
|
||||||
|
|
||||||
|
await waitFor(() => {
|
||||||
|
expect(screen.getByText("Monster XP")).toBeInTheDocument();
|
||||||
|
// 1 PC (<3) triggers party size adjustment
|
||||||
|
expect(screen.getByText("Adjusted for 1 PC")).toBeInTheDocument();
|
||||||
|
});
|
||||||
|
} finally {
|
||||||
|
editionResult.current.setEdition("5.5e");
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
it("shows Net Monster XP for 5.5e edition (no multiplier)", async () => {
|
||||||
|
renderPanel({
|
||||||
|
encounter: defaultEncounter(),
|
||||||
|
playerCharacters: defaultPCs,
|
||||||
|
creatures: new Map([[goblinCreature.id, goblinCreature]]),
|
||||||
|
});
|
||||||
|
|
||||||
|
await waitFor(() => {
|
||||||
|
expect(screen.getByText("Net Monster XP")).toBeInTheDocument();
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
it("calls onClose when Escape is pressed", async () => {
|
it("calls onClose when Escape is pressed", async () => {
|
||||||
const user = userEvent.setup();
|
const user = userEvent.setup();
|
||||||
const onClose = vi.fn();
|
const onClose = vi.fn();
|
||||||
|
|||||||
@@ -3,7 +3,11 @@ import type { DifficultyResult } from "@initiative/domain";
|
|||||||
import { cleanup, render, screen } from "@testing-library/react";
|
import { cleanup, render, screen } from "@testing-library/react";
|
||||||
import userEvent from "@testing-library/user-event";
|
import userEvent from "@testing-library/user-event";
|
||||||
import { afterEach, describe, expect, it, vi } from "vitest";
|
import { afterEach, describe, expect, it, vi } from "vitest";
|
||||||
import { DifficultyIndicator } from "../difficulty-indicator.js";
|
import {
|
||||||
|
DifficultyIndicator,
|
||||||
|
TIER_LABELS_5_5E,
|
||||||
|
TIER_LABELS_2014,
|
||||||
|
} from "../difficulty-indicator.js";
|
||||||
|
|
||||||
afterEach(cleanup);
|
afterEach(cleanup);
|
||||||
|
|
||||||
@@ -11,50 +15,77 @@ function makeResult(tier: DifficultyResult["tier"]): DifficultyResult {
|
|||||||
return {
|
return {
|
||||||
tier,
|
tier,
|
||||||
totalMonsterXp: 100,
|
totalMonsterXp: 100,
|
||||||
partyBudget: { low: 50, moderate: 100, high: 200 },
|
thresholds: [
|
||||||
|
{ label: "Low", value: 50 },
|
||||||
|
{ label: "Moderate", value: 100 },
|
||||||
|
{ label: "High", value: 200 },
|
||||||
|
],
|
||||||
|
encounterMultiplier: undefined,
|
||||||
|
adjustedXp: undefined,
|
||||||
|
partySizeAdjusted: undefined,
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
|
|
||||||
describe("DifficultyIndicator", () => {
|
describe("DifficultyIndicator", () => {
|
||||||
it("renders 3 bars", () => {
|
it("renders 3 bars", () => {
|
||||||
const { container } = render(
|
const { container } = render(
|
||||||
<DifficultyIndicator result={makeResult("moderate")} />,
|
<DifficultyIndicator result={makeResult(2)} labels={TIER_LABELS_5_5E} />,
|
||||||
);
|
);
|
||||||
const bars = container.querySelectorAll("[class*='rounded-sm']");
|
const bars = container.querySelectorAll("[class*='rounded-sm']");
|
||||||
expect(bars).toHaveLength(3);
|
expect(bars).toHaveLength(3);
|
||||||
});
|
});
|
||||||
|
|
||||||
it("shows 'Trivial encounter difficulty' label for trivial tier", () => {
|
it("shows 'Trivial encounter difficulty' for 5.5e tier 0", () => {
|
||||||
render(<DifficultyIndicator result={makeResult("trivial")} />);
|
render(
|
||||||
|
<DifficultyIndicator result={makeResult(0)} labels={TIER_LABELS_5_5E} />,
|
||||||
|
);
|
||||||
expect(
|
expect(
|
||||||
screen.getByRole("img", {
|
screen.getByRole("img", { name: "Trivial encounter difficulty" }),
|
||||||
name: "Trivial encounter difficulty",
|
|
||||||
}),
|
|
||||||
).toBeDefined();
|
).toBeDefined();
|
||||||
});
|
});
|
||||||
|
|
||||||
it("shows 'Low encounter difficulty' label for low tier", () => {
|
it("shows 'Low encounter difficulty' for 5.5e tier 1", () => {
|
||||||
render(<DifficultyIndicator result={makeResult("low")} />);
|
render(
|
||||||
|
<DifficultyIndicator result={makeResult(1)} labels={TIER_LABELS_5_5E} />,
|
||||||
|
);
|
||||||
expect(
|
expect(
|
||||||
screen.getByRole("img", { name: "Low encounter difficulty" }),
|
screen.getByRole("img", { name: "Low encounter difficulty" }),
|
||||||
).toBeDefined();
|
).toBeDefined();
|
||||||
});
|
});
|
||||||
|
|
||||||
it("shows 'Moderate encounter difficulty' label for moderate tier", () => {
|
it("shows 'Moderate encounter difficulty' for 5.5e tier 2", () => {
|
||||||
render(<DifficultyIndicator result={makeResult("moderate")} />);
|
render(
|
||||||
|
<DifficultyIndicator result={makeResult(2)} labels={TIER_LABELS_5_5E} />,
|
||||||
|
);
|
||||||
expect(
|
expect(
|
||||||
screen.getByRole("img", {
|
screen.getByRole("img", { name: "Moderate encounter difficulty" }),
|
||||||
name: "Moderate encounter difficulty",
|
|
||||||
}),
|
|
||||||
).toBeDefined();
|
).toBeDefined();
|
||||||
});
|
});
|
||||||
|
|
||||||
it("shows 'High encounter difficulty' label for high tier", () => {
|
it("shows 'High encounter difficulty' for 5.5e tier 3", () => {
|
||||||
render(<DifficultyIndicator result={makeResult("high")} />);
|
render(
|
||||||
|
<DifficultyIndicator result={makeResult(3)} labels={TIER_LABELS_5_5E} />,
|
||||||
|
);
|
||||||
expect(
|
expect(
|
||||||
screen.getByRole("img", {
|
screen.getByRole("img", { name: "High encounter difficulty" }),
|
||||||
name: "High encounter difficulty",
|
).toBeDefined();
|
||||||
}),
|
});
|
||||||
|
|
||||||
|
it("shows 'Easy encounter difficulty' for 2014 tier 0", () => {
|
||||||
|
render(
|
||||||
|
<DifficultyIndicator result={makeResult(0)} labels={TIER_LABELS_2014} />,
|
||||||
|
);
|
||||||
|
expect(
|
||||||
|
screen.getByRole("img", { name: "Easy encounter difficulty" }),
|
||||||
|
).toBeDefined();
|
||||||
|
});
|
||||||
|
|
||||||
|
it("shows 'Deadly encounter difficulty' for 2014 tier 3", () => {
|
||||||
|
render(
|
||||||
|
<DifficultyIndicator result={makeResult(3)} labels={TIER_LABELS_2014} />,
|
||||||
|
);
|
||||||
|
expect(
|
||||||
|
screen.getByRole("img", { name: "Deadly encounter difficulty" }),
|
||||||
).toBeDefined();
|
).toBeDefined();
|
||||||
});
|
});
|
||||||
|
|
||||||
@@ -63,22 +94,21 @@ describe("DifficultyIndicator", () => {
|
|||||||
const handleClick = vi.fn();
|
const handleClick = vi.fn();
|
||||||
render(
|
render(
|
||||||
<DifficultyIndicator
|
<DifficultyIndicator
|
||||||
result={makeResult("moderate")}
|
result={makeResult(2)}
|
||||||
|
labels={TIER_LABELS_5_5E}
|
||||||
onClick={handleClick}
|
onClick={handleClick}
|
||||||
/>,
|
/>,
|
||||||
);
|
);
|
||||||
|
|
||||||
await user.click(
|
await user.click(
|
||||||
screen.getByRole("img", {
|
screen.getByRole("img", { name: "Moderate encounter difficulty" }),
|
||||||
name: "Moderate encounter difficulty",
|
|
||||||
}),
|
|
||||||
);
|
);
|
||||||
expect(handleClick).toHaveBeenCalledOnce();
|
expect(handleClick).toHaveBeenCalledOnce();
|
||||||
});
|
});
|
||||||
|
|
||||||
it("renders as div when onClick not provided", () => {
|
it("renders as div when onClick not provided", () => {
|
||||||
const { container } = render(
|
const { container } = render(
|
||||||
<DifficultyIndicator result={makeResult("moderate")} />,
|
<DifficultyIndicator result={makeResult(2)} labels={TIER_LABELS_5_5E} />,
|
||||||
);
|
);
|
||||||
const element = container.querySelector("[role='img']");
|
const element = container.querySelector("[role='img']");
|
||||||
expect(element?.tagName).toBe("DIV");
|
expect(element?.tagName).toBe("DIV");
|
||||||
@@ -87,7 +117,8 @@ describe("DifficultyIndicator", () => {
|
|||||||
it("renders as button when onClick provided", () => {
|
it("renders as button when onClick provided", () => {
|
||||||
const { container } = render(
|
const { container } = render(
|
||||||
<DifficultyIndicator
|
<DifficultyIndicator
|
||||||
result={makeResult("moderate")}
|
result={makeResult(2)}
|
||||||
|
labels={TIER_LABELS_5_5E}
|
||||||
onClick={() => {}}
|
onClick={() => {}}
|
||||||
/>,
|
/>,
|
||||||
);
|
);
|
||||||
|
|||||||
@@ -37,14 +37,18 @@ function renderModal(open = true) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
describe("SettingsModal", () => {
|
describe("SettingsModal", () => {
|
||||||
it("renders edition toggle buttons", () => {
|
it("renders game system section with all three options", () => {
|
||||||
renderModal();
|
renderModal();
|
||||||
|
expect(screen.getByText("Game System")).toBeInTheDocument();
|
||||||
expect(
|
expect(
|
||||||
screen.getByRole("button", { name: "5e (2014)" }),
|
screen.getByRole("button", { name: "5e (2014)" }),
|
||||||
).toBeInTheDocument();
|
).toBeInTheDocument();
|
||||||
expect(
|
expect(
|
||||||
screen.getByRole("button", { name: "5.5e (2024)" }),
|
screen.getByRole("button", { name: "5.5e (2024)" }),
|
||||||
).toBeInTheDocument();
|
).toBeInTheDocument();
|
||||||
|
expect(
|
||||||
|
screen.getByRole("button", { name: "Pathfinder 2e" }),
|
||||||
|
).toBeInTheDocument();
|
||||||
});
|
});
|
||||||
|
|
||||||
it("renders theme toggle buttons", () => {
|
it("renders theme toggle buttons", () => {
|
||||||
|
|||||||
@@ -6,6 +6,7 @@ import userEvent from "@testing-library/user-event";
|
|||||||
import { afterEach, describe, expect, it, vi } from "vitest";
|
import { afterEach, describe, expect, it, vi } from "vitest";
|
||||||
import { createTestAdapters } from "../../__tests__/adapters/in-memory-adapters.js";
|
import { createTestAdapters } from "../../__tests__/adapters/in-memory-adapters.js";
|
||||||
import { AdapterProvider } from "../../contexts/adapter-context.js";
|
import { AdapterProvider } from "../../contexts/adapter-context.js";
|
||||||
|
import { RulesEditionProvider } from "../../contexts/rules-edition-context.js";
|
||||||
import { SourceFetchPrompt } from "../source-fetch-prompt.js";
|
import { SourceFetchPrompt } from "../source-fetch-prompt.js";
|
||||||
|
|
||||||
const MONSTER_MANUAL_REGEX = /Monster Manual/;
|
const MONSTER_MANUAL_REGEX = /Monster Manual/;
|
||||||
@@ -36,12 +37,14 @@ function renderPrompt(sourceCode = "MM") {
|
|||||||
code === "MM" ? "Monster Manual" : code,
|
code === "MM" ? "Monster Manual" : code,
|
||||||
};
|
};
|
||||||
const result = render(
|
const result = render(
|
||||||
|
<RulesEditionProvider>
|
||||||
<AdapterProvider adapters={adapters}>
|
<AdapterProvider adapters={adapters}>
|
||||||
<SourceFetchPrompt
|
<SourceFetchPrompt
|
||||||
sourceCode={sourceCode}
|
sourceCode={sourceCode}
|
||||||
onSourceLoaded={onSourceLoaded}
|
onSourceLoaded={onSourceLoaded}
|
||||||
/>
|
/>
|
||||||
</AdapterProvider>,
|
</AdapterProvider>
|
||||||
|
</RulesEditionProvider>,
|
||||||
);
|
);
|
||||||
return { ...result, onSourceLoaded };
|
return { ...result, onSourceLoaded };
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -36,7 +36,7 @@ function renderWithSources(sources: CachedSourceInfo[] = []) {
|
|||||||
adapters.bestiaryCache = {
|
adapters.bestiaryCache = {
|
||||||
...adapters.bestiaryCache,
|
...adapters.bestiaryCache,
|
||||||
getCachedSources: () => Promise.resolve(currentSources),
|
getCachedSources: () => Promise.resolve(currentSources),
|
||||||
clearSource(sourceCode) {
|
clearSource(_system, sourceCode) {
|
||||||
currentSources = currentSources.filter(
|
currentSources = currentSources.filter(
|
||||||
(s) => s.sourceCode !== sourceCode,
|
(s) => s.sourceCode !== sourceCode,
|
||||||
);
|
);
|
||||||
|
|||||||
@@ -5,7 +5,7 @@ import type { Creature } from "@initiative/domain";
|
|||||||
import { creatureId } from "@initiative/domain";
|
import { creatureId } from "@initiative/domain";
|
||||||
import { cleanup, render, screen } from "@testing-library/react";
|
import { cleanup, render, screen } from "@testing-library/react";
|
||||||
import { afterEach, describe, expect, it } from "vitest";
|
import { afterEach, describe, expect, it } from "vitest";
|
||||||
import { StatBlock } from "../stat-block.js";
|
import { DndStatBlock as StatBlock } from "../dnd-stat-block.js";
|
||||||
|
|
||||||
afterEach(cleanup);
|
afterEach(cleanup);
|
||||||
|
|
||||||
@@ -46,10 +46,30 @@ const GOBLIN: Creature = {
|
|||||||
skills: "Stealth +6",
|
skills: "Stealth +6",
|
||||||
senses: "darkvision 60 ft., passive Perception 9",
|
senses: "darkvision 60 ft., passive Perception 9",
|
||||||
languages: "Common, Goblin",
|
languages: "Common, Goblin",
|
||||||
traits: [{ name: "Nimble Escape", text: "Disengage or Hide as bonus." }],
|
traits: [
|
||||||
actions: [{ name: "Scimitar", text: "Melee: +4 to hit, 5 slashing." }],
|
{
|
||||||
bonusActions: [{ name: "Nimble", text: "Disengage or Hide." }],
|
name: "Nimble Escape",
|
||||||
reactions: [{ name: "Redirect", text: "Redirect attack to ally." }],
|
segments: [{ type: "text", value: "Disengage or Hide as bonus." }],
|
||||||
|
},
|
||||||
|
],
|
||||||
|
actions: [
|
||||||
|
{
|
||||||
|
name: "Scimitar",
|
||||||
|
segments: [{ type: "text", value: "Melee: +4 to hit, 5 slashing." }],
|
||||||
|
},
|
||||||
|
],
|
||||||
|
bonusActions: [
|
||||||
|
{
|
||||||
|
name: "Nimble",
|
||||||
|
segments: [{ type: "text", value: "Disengage or Hide." }],
|
||||||
|
},
|
||||||
|
],
|
||||||
|
reactions: [
|
||||||
|
{
|
||||||
|
name: "Redirect",
|
||||||
|
segments: [{ type: "text", value: "Redirect attack to ally." }],
|
||||||
|
},
|
||||||
|
],
|
||||||
};
|
};
|
||||||
|
|
||||||
const DRAGON: Creature = {
|
const DRAGON: Creature = {
|
||||||
@@ -75,8 +95,16 @@ const DRAGON: Creature = {
|
|||||||
legendaryActions: {
|
legendaryActions: {
|
||||||
preamble: "The dragon can take 3 legendary actions.",
|
preamble: "The dragon can take 3 legendary actions.",
|
||||||
entries: [
|
entries: [
|
||||||
{ name: "Detect", text: "Wisdom (Perception) check." },
|
{
|
||||||
{ name: "Tail Attack", text: "Tail attack." },
|
name: "Detect",
|
||||||
|
segments: [
|
||||||
|
{ type: "text" as const, value: "Wisdom (Perception) check." },
|
||||||
|
],
|
||||||
|
},
|
||||||
|
{
|
||||||
|
name: "Tail Attack",
|
||||||
|
segments: [{ type: "text" as const, value: "Tail attack." }],
|
||||||
|
},
|
||||||
],
|
],
|
||||||
},
|
},
|
||||||
spellcasting: [
|
spellcasting: [
|
||||||
|
|||||||
@@ -3,23 +3,30 @@ import { useId, useState } from "react";
|
|||||||
import { useAdapters } from "../contexts/adapter-context.js";
|
import { useAdapters } from "../contexts/adapter-context.js";
|
||||||
import { useBestiaryContext } from "../contexts/bestiary-context.js";
|
import { useBestiaryContext } from "../contexts/bestiary-context.js";
|
||||||
import { useBulkImportContext } from "../contexts/bulk-import-context.js";
|
import { useBulkImportContext } from "../contexts/bulk-import-context.js";
|
||||||
|
import { useRulesEditionContext } from "../contexts/rules-edition-context.js";
|
||||||
import { useSidePanelContext } from "../contexts/side-panel-context.js";
|
import { useSidePanelContext } from "../contexts/side-panel-context.js";
|
||||||
import { Button } from "./ui/button.js";
|
import { Button } from "./ui/button.js";
|
||||||
import { Input } from "./ui/input.js";
|
import { Input } from "./ui/input.js";
|
||||||
|
|
||||||
const DEFAULT_BASE_URL =
|
const DND_BASE_URL =
|
||||||
"https://raw.githubusercontent.com/5etools-mirror-3/5etools-src/main/data/bestiary/";
|
"https://raw.githubusercontent.com/5etools-mirror-3/5etools-src/main/data/bestiary/";
|
||||||
|
|
||||||
|
const PF2E_BASE_URL =
|
||||||
|
"https://raw.githubusercontent.com/Pf2eToolsOrg/Pf2eTools/dev/data/bestiary/";
|
||||||
|
|
||||||
export function BulkImportPrompt() {
|
export function BulkImportPrompt() {
|
||||||
const { bestiaryIndex } = useAdapters();
|
const { bestiaryIndex, pf2eBestiaryIndex } = useAdapters();
|
||||||
const { fetchAndCacheSource, isSourceCached, refreshCache } =
|
const { fetchAndCacheSource, isSourceCached, refreshCache } =
|
||||||
useBestiaryContext();
|
useBestiaryContext();
|
||||||
const { state: importState, startImport, reset } = useBulkImportContext();
|
const { state: importState, startImport, reset } = useBulkImportContext();
|
||||||
const { dismissPanel } = useSidePanelContext();
|
const { dismissPanel } = useSidePanelContext();
|
||||||
|
const { edition } = useRulesEditionContext();
|
||||||
|
|
||||||
const [baseUrl, setBaseUrl] = useState(DEFAULT_BASE_URL);
|
const indexPort = edition === "pf2e" ? pf2eBestiaryIndex : bestiaryIndex;
|
||||||
|
const defaultUrl = edition === "pf2e" ? PF2E_BASE_URL : DND_BASE_URL;
|
||||||
|
const [baseUrl, setBaseUrl] = useState(defaultUrl);
|
||||||
const baseUrlId = useId();
|
const baseUrlId = useId();
|
||||||
const totalSources = bestiaryIndex.getAllSourceCodes().length;
|
const totalSources = indexPort.getAllSourceCodes().length;
|
||||||
|
|
||||||
const handleStart = (url: string) => {
|
const handleStart = (url: string) => {
|
||||||
startImport(url, fetchAndCacheSource, isSourceCached, refreshCache);
|
startImport(url, fetchAndCacheSource, isSourceCached, refreshCache);
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
import {
|
import {
|
||||||
type CombatantId,
|
type CombatantId,
|
||||||
type ConditionId,
|
type ConditionEntry,
|
||||||
type CreatureId,
|
type CreatureId,
|
||||||
deriveHpStatus,
|
deriveHpStatus,
|
||||||
type PlayerIcon,
|
type PlayerIcon,
|
||||||
@@ -31,7 +31,7 @@ interface Combatant {
|
|||||||
readonly currentHp?: number;
|
readonly currentHp?: number;
|
||||||
readonly tempHp?: number;
|
readonly tempHp?: number;
|
||||||
readonly ac?: number;
|
readonly ac?: number;
|
||||||
readonly conditions?: readonly ConditionId[];
|
readonly conditions?: readonly ConditionEntry[];
|
||||||
readonly isConcentrating?: boolean;
|
readonly isConcentrating?: boolean;
|
||||||
readonly color?: string;
|
readonly color?: string;
|
||||||
readonly icon?: string;
|
readonly icon?: string;
|
||||||
@@ -448,6 +448,8 @@ export function CombatantRow({
|
|||||||
setTempHp,
|
setTempHp,
|
||||||
setAc,
|
setAc,
|
||||||
toggleCondition,
|
toggleCondition,
|
||||||
|
setConditionValue,
|
||||||
|
decrementCondition,
|
||||||
toggleConcentration,
|
toggleConcentration,
|
||||||
} = useEncounterContext();
|
} = useEncounterContext();
|
||||||
const { selectedCreatureId, showCreature, toggleCollapse } =
|
const { selectedCreatureId, showCreature, toggleCollapse } =
|
||||||
@@ -585,6 +587,7 @@ export function CombatantRow({
|
|||||||
<ConditionTags
|
<ConditionTags
|
||||||
conditions={combatant.conditions}
|
conditions={combatant.conditions}
|
||||||
onRemove={(conditionId) => toggleCondition(id, conditionId)}
|
onRemove={(conditionId) => toggleCondition(id, conditionId)}
|
||||||
|
onDecrement={(conditionId) => decrementCondition(id, conditionId)}
|
||||||
onOpenPicker={() => setPickerOpen((prev) => !prev)}
|
onOpenPicker={() => setPickerOpen((prev) => !prev)}
|
||||||
/>
|
/>
|
||||||
</div>
|
</div>
|
||||||
@@ -593,6 +596,9 @@ export function CombatantRow({
|
|||||||
anchorRef={conditionAnchorRef}
|
anchorRef={conditionAnchorRef}
|
||||||
activeConditions={combatant.conditions}
|
activeConditions={combatant.conditions}
|
||||||
onToggle={(conditionId) => toggleCondition(id, conditionId)}
|
onToggle={(conditionId) => toggleCondition(id, conditionId)}
|
||||||
|
onSetValue={(conditionId, value) =>
|
||||||
|
setConditionValue(id, conditionId, value)
|
||||||
|
}
|
||||||
onClose={() => setPickerOpen(false)}
|
onClose={() => setPickerOpen(false)}
|
||||||
/>
|
/>
|
||||||
)}
|
)}
|
||||||
|
|||||||
@@ -1,8 +1,10 @@
|
|||||||
import {
|
import {
|
||||||
|
type ConditionEntry,
|
||||||
type ConditionId,
|
type ConditionId,
|
||||||
getConditionDescription,
|
getConditionDescription,
|
||||||
getConditionsForEdition,
|
getConditionsForEdition,
|
||||||
} from "@initiative/domain";
|
} from "@initiative/domain";
|
||||||
|
import { Check, Minus, Plus } from "lucide-react";
|
||||||
import { useLayoutEffect, useRef, useState } from "react";
|
import { useLayoutEffect, useRef, useState } from "react";
|
||||||
import { createPortal } from "react-dom";
|
import { createPortal } from "react-dom";
|
||||||
import { useRulesEditionContext } from "../contexts/rules-edition-context.js";
|
import { useRulesEditionContext } from "../contexts/rules-edition-context.js";
|
||||||
@@ -16,8 +18,9 @@ import { Tooltip } from "./ui/tooltip.js";
|
|||||||
|
|
||||||
interface ConditionPickerProps {
|
interface ConditionPickerProps {
|
||||||
anchorRef: React.RefObject<HTMLElement | null>;
|
anchorRef: React.RefObject<HTMLElement | null>;
|
||||||
activeConditions: readonly ConditionId[] | undefined;
|
activeConditions: readonly ConditionEntry[] | undefined;
|
||||||
onToggle: (conditionId: ConditionId) => void;
|
onToggle: (conditionId: ConditionId) => void;
|
||||||
|
onSetValue: (conditionId: ConditionId, value: number) => void;
|
||||||
onClose: () => void;
|
onClose: () => void;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -25,6 +28,7 @@ export function ConditionPicker({
|
|||||||
anchorRef,
|
anchorRef,
|
||||||
activeConditions,
|
activeConditions,
|
||||||
onToggle,
|
onToggle,
|
||||||
|
onSetValue,
|
||||||
onClose,
|
onClose,
|
||||||
}: Readonly<ConditionPickerProps>) {
|
}: Readonly<ConditionPickerProps>) {
|
||||||
const ref = useRef<HTMLDivElement>(null);
|
const ref = useRef<HTMLDivElement>(null);
|
||||||
@@ -34,6 +38,11 @@ export function ConditionPicker({
|
|||||||
maxHeight: number;
|
maxHeight: number;
|
||||||
} | null>(null);
|
} | null>(null);
|
||||||
|
|
||||||
|
const [editing, setEditing] = useState<{
|
||||||
|
id: ConditionId;
|
||||||
|
value: number;
|
||||||
|
} | null>(null);
|
||||||
|
|
||||||
useLayoutEffect(() => {
|
useLayoutEffect(() => {
|
||||||
const anchor = anchorRef.current;
|
const anchor = anchorRef.current;
|
||||||
const el = ref.current;
|
const el = ref.current;
|
||||||
@@ -59,7 +68,9 @@ export function ConditionPicker({
|
|||||||
|
|
||||||
const { edition } = useRulesEditionContext();
|
const { edition } = useRulesEditionContext();
|
||||||
const conditions = getConditionsForEdition(edition);
|
const conditions = getConditionsForEdition(edition);
|
||||||
const active = new Set(activeConditions ?? []);
|
const activeMap = new Map(
|
||||||
|
(activeConditions ?? []).map((e) => [e.id, e.value]),
|
||||||
|
);
|
||||||
|
|
||||||
return createPortal(
|
return createPortal(
|
||||||
<div
|
<div
|
||||||
@@ -74,35 +85,112 @@ export function ConditionPicker({
|
|||||||
{conditions.map((def) => {
|
{conditions.map((def) => {
|
||||||
const Icon = CONDITION_ICON_MAP[def.iconName];
|
const Icon = CONDITION_ICON_MAP[def.iconName];
|
||||||
if (!Icon) return null;
|
if (!Icon) return null;
|
||||||
const isActive = active.has(def.id);
|
const isActive = activeMap.has(def.id);
|
||||||
|
const activeValue = activeMap.get(def.id);
|
||||||
|
const isEditing = editing?.id === def.id;
|
||||||
const colorClass =
|
const colorClass =
|
||||||
CONDITION_COLOR_CLASSES[def.color] ?? "text-muted-foreground";
|
CONDITION_COLOR_CLASSES[def.color] ?? "text-muted-foreground";
|
||||||
|
|
||||||
|
const handleClick = () => {
|
||||||
|
if (def.valued && edition === "pf2e") {
|
||||||
|
const current = activeMap.get(def.id);
|
||||||
|
setEditing({
|
||||||
|
id: def.id,
|
||||||
|
value: current ?? 1,
|
||||||
|
});
|
||||||
|
} else {
|
||||||
|
onToggle(def.id);
|
||||||
|
}
|
||||||
|
};
|
||||||
|
|
||||||
return (
|
return (
|
||||||
<Tooltip
|
<Tooltip
|
||||||
key={def.id}
|
key={def.id}
|
||||||
content={getConditionDescription(def, edition)}
|
content={getConditionDescription(def, edition)}
|
||||||
className="block"
|
className="block"
|
||||||
|
>
|
||||||
|
<div
|
||||||
|
className={cn(
|
||||||
|
"flex w-full items-center gap-2 rounded px-2 py-1 text-sm transition-colors",
|
||||||
|
(isActive || isEditing) && "bg-card/50",
|
||||||
|
)}
|
||||||
>
|
>
|
||||||
<button
|
<button
|
||||||
type="button"
|
type="button"
|
||||||
className={cn(
|
className="flex flex-1 items-center gap-2"
|
||||||
"flex w-full items-center gap-2 rounded px-2 py-1 text-sm transition-colors hover:bg-hover-neutral-bg",
|
onClick={handleClick}
|
||||||
isActive && "bg-card/50",
|
|
||||||
)}
|
|
||||||
onClick={() => onToggle(def.id)}
|
|
||||||
>
|
>
|
||||||
<Icon
|
<Icon
|
||||||
size={14}
|
size={14}
|
||||||
className={isActive ? colorClass : "text-muted-foreground"}
|
className={
|
||||||
|
isActive || isEditing ? colorClass : "text-muted-foreground"
|
||||||
|
}
|
||||||
/>
|
/>
|
||||||
<span
|
<span
|
||||||
className={
|
className={
|
||||||
isActive ? "text-foreground" : "text-muted-foreground"
|
isActive || isEditing
|
||||||
|
? "text-foreground"
|
||||||
|
: "text-muted-foreground"
|
||||||
}
|
}
|
||||||
>
|
>
|
||||||
{def.label}
|
{def.label}
|
||||||
</span>
|
</span>
|
||||||
</button>
|
</button>
|
||||||
|
{isActive && def.valued && edition === "pf2e" && !isEditing && (
|
||||||
|
<span className="min-w-5 rounded-full bg-accent px-1.5 py-0.5 text-center font-medium text-primary-foreground text-xs">
|
||||||
|
{activeValue}
|
||||||
|
</span>
|
||||||
|
)}
|
||||||
|
{isEditing && (
|
||||||
|
<div className="flex items-center gap-0.5">
|
||||||
|
<button
|
||||||
|
type="button"
|
||||||
|
className="rounded p-0.5 text-foreground hover:bg-accent/40"
|
||||||
|
onMouseDown={(e) => e.preventDefault()}
|
||||||
|
onClick={(e) => {
|
||||||
|
e.stopPropagation();
|
||||||
|
if (editing.value > 1) {
|
||||||
|
setEditing({
|
||||||
|
...editing,
|
||||||
|
value: editing.value - 1,
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}}
|
||||||
|
>
|
||||||
|
<Minus className="h-3 w-3" />
|
||||||
|
</button>
|
||||||
|
<span className="min-w-5 rounded-full bg-accent px-1.5 py-0.5 text-center font-medium text-primary-foreground text-xs">
|
||||||
|
{editing.value}
|
||||||
|
</span>
|
||||||
|
<button
|
||||||
|
type="button"
|
||||||
|
className="rounded p-0.5 text-foreground hover:bg-accent/40"
|
||||||
|
onMouseDown={(e) => e.preventDefault()}
|
||||||
|
onClick={(e) => {
|
||||||
|
e.stopPropagation();
|
||||||
|
setEditing({
|
||||||
|
...editing,
|
||||||
|
value: editing.value + 1,
|
||||||
|
});
|
||||||
|
}}
|
||||||
|
>
|
||||||
|
<Plus className="h-3 w-3" />
|
||||||
|
</button>
|
||||||
|
<button
|
||||||
|
type="button"
|
||||||
|
className="ml-0.5 rounded p-0.5 text-foreground hover:bg-accent/40"
|
||||||
|
onMouseDown={(e) => e.preventDefault()}
|
||||||
|
onClick={(e) => {
|
||||||
|
e.stopPropagation();
|
||||||
|
onSetValue(editing.id, editing.value);
|
||||||
|
setEditing(null);
|
||||||
|
}}
|
||||||
|
>
|
||||||
|
<Check className="h-3.5 w-3.5" />
|
||||||
|
</button>
|
||||||
|
</div>
|
||||||
|
)}
|
||||||
|
</div>
|
||||||
</Tooltip>
|
</Tooltip>
|
||||||
);
|
);
|
||||||
})}
|
})}
|
||||||
|
|||||||
@@ -1,42 +1,74 @@
|
|||||||
import type { LucideIcon } from "lucide-react";
|
import type { LucideIcon } from "lucide-react";
|
||||||
import {
|
import {
|
||||||
|
Anchor,
|
||||||
ArrowDown,
|
ArrowDown,
|
||||||
Ban,
|
Ban,
|
||||||
BatteryLow,
|
BatteryLow,
|
||||||
|
BrainCog,
|
||||||
|
CircleHelp,
|
||||||
|
CloudFog,
|
||||||
|
Drama,
|
||||||
Droplet,
|
Droplet,
|
||||||
|
Droplets,
|
||||||
EarOff,
|
EarOff,
|
||||||
|
Eye,
|
||||||
EyeOff,
|
EyeOff,
|
||||||
|
Footprints,
|
||||||
Gem,
|
Gem,
|
||||||
Ghost,
|
Ghost,
|
||||||
Hand,
|
Hand,
|
||||||
Heart,
|
Heart,
|
||||||
|
HeartCrack,
|
||||||
|
HeartPulse,
|
||||||
Link,
|
Link,
|
||||||
Moon,
|
Moon,
|
||||||
|
PersonStanding,
|
||||||
ShieldMinus,
|
ShieldMinus,
|
||||||
|
ShieldOff,
|
||||||
Siren,
|
Siren,
|
||||||
|
Skull,
|
||||||
Snail,
|
Snail,
|
||||||
Sparkles,
|
Sparkles,
|
||||||
|
Sun,
|
||||||
|
TrendingDown,
|
||||||
|
Zap,
|
||||||
ZapOff,
|
ZapOff,
|
||||||
} from "lucide-react";
|
} from "lucide-react";
|
||||||
|
|
||||||
export const CONDITION_ICON_MAP: Record<string, LucideIcon> = {
|
export const CONDITION_ICON_MAP: Record<string, LucideIcon> = {
|
||||||
EyeOff,
|
Anchor,
|
||||||
Heart,
|
|
||||||
EarOff,
|
|
||||||
BatteryLow,
|
|
||||||
Siren,
|
|
||||||
Hand,
|
|
||||||
Ban,
|
|
||||||
Ghost,
|
|
||||||
ZapOff,
|
|
||||||
Gem,
|
|
||||||
Droplet,
|
|
||||||
ArrowDown,
|
ArrowDown,
|
||||||
|
Ban,
|
||||||
|
BatteryLow,
|
||||||
|
BrainCog,
|
||||||
|
CircleHelp,
|
||||||
|
CloudFog,
|
||||||
|
Drama,
|
||||||
|
Droplet,
|
||||||
|
Droplets,
|
||||||
|
EarOff,
|
||||||
|
Eye,
|
||||||
|
EyeOff,
|
||||||
|
Footprints,
|
||||||
|
Gem,
|
||||||
|
Ghost,
|
||||||
|
Hand,
|
||||||
|
Heart,
|
||||||
|
HeartCrack,
|
||||||
|
HeartPulse,
|
||||||
Link,
|
Link,
|
||||||
|
Moon,
|
||||||
|
PersonStanding,
|
||||||
ShieldMinus,
|
ShieldMinus,
|
||||||
|
ShieldOff,
|
||||||
|
Siren,
|
||||||
|
Skull,
|
||||||
Snail,
|
Snail,
|
||||||
Sparkles,
|
Sparkles,
|
||||||
Moon,
|
Sun,
|
||||||
|
TrendingDown,
|
||||||
|
Zap,
|
||||||
|
ZapOff,
|
||||||
};
|
};
|
||||||
|
|
||||||
export const CONDITION_COLOR_CLASSES: Record<string, string> = {
|
export const CONDITION_COLOR_CLASSES: Record<string, string> = {
|
||||||
@@ -51,4 +83,5 @@ export const CONDITION_COLOR_CLASSES: Record<string, string> = {
|
|||||||
green: "text-green-400",
|
green: "text-green-400",
|
||||||
indigo: "text-indigo-400",
|
indigo: "text-indigo-400",
|
||||||
sky: "text-sky-400",
|
sky: "text-sky-400",
|
||||||
|
red: "text-red-400",
|
||||||
};
|
};
|
||||||
|
|||||||
@@ -1,5 +1,6 @@
|
|||||||
import {
|
import {
|
||||||
CONDITION_DEFINITIONS,
|
CONDITION_DEFINITIONS,
|
||||||
|
type ConditionEntry,
|
||||||
type ConditionId,
|
type ConditionId,
|
||||||
getConditionDescription,
|
getConditionDescription,
|
||||||
} from "@initiative/domain";
|
} from "@initiative/domain";
|
||||||
@@ -13,44 +14,57 @@ import {
|
|||||||
import { Tooltip } from "./ui/tooltip.js";
|
import { Tooltip } from "./ui/tooltip.js";
|
||||||
|
|
||||||
interface ConditionTagsProps {
|
interface ConditionTagsProps {
|
||||||
conditions: readonly ConditionId[] | undefined;
|
conditions: readonly ConditionEntry[] | undefined;
|
||||||
onRemove: (conditionId: ConditionId) => void;
|
onRemove: (conditionId: ConditionId) => void;
|
||||||
|
onDecrement: (conditionId: ConditionId) => void;
|
||||||
onOpenPicker: () => void;
|
onOpenPicker: () => void;
|
||||||
}
|
}
|
||||||
|
|
||||||
export function ConditionTags({
|
export function ConditionTags({
|
||||||
conditions,
|
conditions,
|
||||||
onRemove,
|
onRemove,
|
||||||
|
onDecrement,
|
||||||
onOpenPicker,
|
onOpenPicker,
|
||||||
}: Readonly<ConditionTagsProps>) {
|
}: Readonly<ConditionTagsProps>) {
|
||||||
const { edition } = useRulesEditionContext();
|
const { edition } = useRulesEditionContext();
|
||||||
return (
|
return (
|
||||||
<div className="flex flex-wrap items-center gap-0.5">
|
<div className="flex flex-wrap items-center gap-0.5">
|
||||||
{conditions?.map((condId) => {
|
{conditions?.map((entry) => {
|
||||||
const def = CONDITION_DEFINITIONS.find((d) => d.id === condId);
|
const def = CONDITION_DEFINITIONS.find((d) => d.id === entry.id);
|
||||||
if (!def) return null;
|
if (!def) return null;
|
||||||
const Icon = CONDITION_ICON_MAP[def.iconName];
|
const Icon = CONDITION_ICON_MAP[def.iconName];
|
||||||
if (!Icon) return null;
|
if (!Icon) return null;
|
||||||
const colorClass =
|
const colorClass =
|
||||||
CONDITION_COLOR_CLASSES[def.color] ?? "text-muted-foreground";
|
CONDITION_COLOR_CLASSES[def.color] ?? "text-muted-foreground";
|
||||||
|
const tooltipLabel =
|
||||||
|
entry.value === undefined ? def.label : `${def.label} ${entry.value}`;
|
||||||
return (
|
return (
|
||||||
<Tooltip
|
<Tooltip
|
||||||
key={condId}
|
key={entry.id}
|
||||||
content={`${def.label}:\n${getConditionDescription(def, edition)}`}
|
content={`${tooltipLabel}:\n${getConditionDescription(def, edition)}`}
|
||||||
>
|
>
|
||||||
<button
|
<button
|
||||||
type="button"
|
type="button"
|
||||||
aria-label={`Remove ${def.label}`}
|
aria-label={`Remove ${def.label}`}
|
||||||
className={cn(
|
className={cn(
|
||||||
"inline-flex items-center rounded p-0.5 transition-colors hover:bg-hover-neutral-bg",
|
"inline-flex items-center gap-0.5 rounded p-0.5 transition-colors hover:bg-hover-neutral-bg",
|
||||||
colorClass,
|
colorClass,
|
||||||
)}
|
)}
|
||||||
onClick={(e) => {
|
onClick={(e) => {
|
||||||
e.stopPropagation();
|
e.stopPropagation();
|
||||||
onRemove(condId);
|
if (entry.value === undefined) {
|
||||||
|
onRemove(entry.id);
|
||||||
|
} else {
|
||||||
|
onDecrement(entry.id);
|
||||||
|
}
|
||||||
}}
|
}}
|
||||||
>
|
>
|
||||||
<Icon size={14} />
|
<Icon size={14} />
|
||||||
|
{entry.value !== undefined && (
|
||||||
|
<span className="font-medium text-xs leading-none">
|
||||||
|
{entry.value}
|
||||||
|
</span>
|
||||||
|
)}
|
||||||
</button>
|
</button>
|
||||||
</Tooltip>
|
</Tooltip>
|
||||||
);
|
);
|
||||||
|
|||||||
@@ -1,37 +1,96 @@
|
|||||||
import type { DifficultyTier } from "@initiative/domain";
|
import type { DifficultyTier, RulesEdition } from "@initiative/domain";
|
||||||
|
import { ArrowLeftRight } from "lucide-react";
|
||||||
import { useRef } from "react";
|
import { useRef } from "react";
|
||||||
import { useEncounterContext } from "../contexts/encounter-context.js";
|
import { useEncounterContext } from "../contexts/encounter-context.js";
|
||||||
|
import { useRulesEditionContext } from "../contexts/rules-edition-context.js";
|
||||||
import { useClickOutside } from "../hooks/use-click-outside.js";
|
import { useClickOutside } from "../hooks/use-click-outside.js";
|
||||||
import {
|
import {
|
||||||
type BreakdownCombatant,
|
type BreakdownCombatant,
|
||||||
useDifficultyBreakdown,
|
useDifficultyBreakdown,
|
||||||
} from "../hooks/use-difficulty-breakdown.js";
|
} from "../hooks/use-difficulty-breakdown.js";
|
||||||
import { CrPicker } from "./cr-picker.js";
|
import { CrPicker } from "./cr-picker.js";
|
||||||
|
import { Button } from "./ui/button.js";
|
||||||
|
|
||||||
const TIER_LABELS: Record<DifficultyTier, { label: string; color: string }> = {
|
const TIER_LABEL_MAP: Partial<
|
||||||
trivial: { label: "Trivial", color: "text-muted-foreground" },
|
Record<RulesEdition, Record<DifficultyTier, { label: string; color: string }>>
|
||||||
low: { label: "Low", color: "text-green-500" },
|
> = {
|
||||||
moderate: { label: "Moderate", color: "text-yellow-500" },
|
"5.5e": {
|
||||||
high: { label: "High", color: "text-red-500" },
|
0: { label: "Trivial", color: "text-muted-foreground" },
|
||||||
|
1: { label: "Low", color: "text-green-500" },
|
||||||
|
2: { label: "Moderate", color: "text-yellow-500" },
|
||||||
|
3: { label: "High", color: "text-red-500" },
|
||||||
|
},
|
||||||
|
"5e": {
|
||||||
|
0: { label: "Easy", color: "text-muted-foreground" },
|
||||||
|
1: { label: "Medium", color: "text-green-500" },
|
||||||
|
2: { label: "Hard", color: "text-yellow-500" },
|
||||||
|
3: { label: "Deadly", color: "text-red-500" },
|
||||||
|
},
|
||||||
};
|
};
|
||||||
|
|
||||||
|
/** Short labels for threshold display where horizontal space is limited. */
|
||||||
|
const SHORT_LABELS: Readonly<Record<string, string>> = {
|
||||||
|
Moderate: "Mod",
|
||||||
|
Medium: "Med",
|
||||||
|
};
|
||||||
|
|
||||||
|
function shortLabel(label: string): string {
|
||||||
|
return SHORT_LABELS[label] ?? label;
|
||||||
|
}
|
||||||
|
|
||||||
function formatXp(xp: number): string {
|
function formatXp(xp: number): string {
|
||||||
return xp.toLocaleString();
|
return xp.toLocaleString();
|
||||||
}
|
}
|
||||||
|
|
||||||
function CombatantRow({ entry }: { entry: BreakdownCombatant }) {
|
function PcRow({ entry }: { entry: BreakdownCombatant }) {
|
||||||
const { setCr } = useEncounterContext();
|
return (
|
||||||
|
<div className="col-span-4 grid grid-cols-subgrid items-center text-xs">
|
||||||
|
<span className="min-w-0 truncate" title={entry.combatant.name}>
|
||||||
|
{entry.combatant.name}
|
||||||
|
</span>
|
||||||
|
<span />
|
||||||
|
<span className="text-muted-foreground">
|
||||||
|
{entry.level === undefined ? "\u2014" : `Lv ${entry.level}`}
|
||||||
|
</span>
|
||||||
|
<span className="text-right tabular-nums">{"\u2014"}</span>
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
const nameLabel = entry.source
|
function NpcRow({
|
||||||
? `${entry.combatant.name} (${entry.source})`
|
entry,
|
||||||
: entry.combatant.name;
|
onToggleSide,
|
||||||
|
}: {
|
||||||
|
entry: BreakdownCombatant;
|
||||||
|
onToggleSide: () => void;
|
||||||
|
}) {
|
||||||
|
const { setCr } = useEncounterContext();
|
||||||
|
const isParty = entry.side === "party";
|
||||||
|
const targetSide = isParty ? "enemy" : "party";
|
||||||
|
|
||||||
|
let xpDisplay: string;
|
||||||
|
if (entry.xp == null) {
|
||||||
|
xpDisplay = "\u2014";
|
||||||
|
} else if (isParty && entry.cr) {
|
||||||
|
xpDisplay = `\u2212${formatXp(entry.xp)}`;
|
||||||
|
} else {
|
||||||
|
xpDisplay = formatXp(entry.xp);
|
||||||
|
}
|
||||||
|
|
||||||
return (
|
return (
|
||||||
<div className="flex items-center justify-between gap-2 text-xs">
|
<div className="col-span-4 grid grid-cols-subgrid items-center text-xs">
|
||||||
<span className="min-w-0 truncate" title={nameLabel}>
|
<span className="min-w-0 truncate" title={entry.combatant.name}>
|
||||||
{nameLabel}
|
{entry.combatant.name}
|
||||||
</span>
|
</span>
|
||||||
<div className="flex shrink-0 items-center gap-2">
|
<Button
|
||||||
|
variant="ghost"
|
||||||
|
size="icon-sm"
|
||||||
|
onClick={onToggleSide}
|
||||||
|
aria-label={`Move ${entry.combatant.name} to ${targetSide} side`}
|
||||||
|
>
|
||||||
|
<ArrowLeftRight className="h-3 w-3" />
|
||||||
|
</Button>
|
||||||
|
<span>
|
||||||
{entry.editable ? (
|
{entry.editable ? (
|
||||||
<CrPicker
|
<CrPicker
|
||||||
value={entry.cr}
|
value={entry.cr}
|
||||||
@@ -39,13 +98,11 @@ function CombatantRow({ entry }: { entry: BreakdownCombatant }) {
|
|||||||
/>
|
/>
|
||||||
) : (
|
) : (
|
||||||
<span className="text-muted-foreground">
|
<span className="text-muted-foreground">
|
||||||
{entry.cr ? `CR ${entry.cr}` : "—"}
|
{entry.cr ? `CR ${entry.cr}` : "\u2014"}
|
||||||
</span>
|
</span>
|
||||||
)}
|
)}
|
||||||
<span className="w-12 text-right tabular-nums">
|
|
||||||
{entry.xp == null ? "—" : formatXp(entry.xp)}
|
|
||||||
</span>
|
</span>
|
||||||
</div>
|
<span className="text-right tabular-nums">{xpDisplay}</span>
|
||||||
</div>
|
</div>
|
||||||
);
|
);
|
||||||
}
|
}
|
||||||
@@ -53,16 +110,28 @@ function CombatantRow({ entry }: { entry: BreakdownCombatant }) {
|
|||||||
export function DifficultyBreakdownPanel({ onClose }: { onClose: () => void }) {
|
export function DifficultyBreakdownPanel({ onClose }: { onClose: () => void }) {
|
||||||
const ref = useRef<HTMLDivElement>(null);
|
const ref = useRef<HTMLDivElement>(null);
|
||||||
useClickOutside(ref, onClose);
|
useClickOutside(ref, onClose);
|
||||||
|
const { setSide } = useEncounterContext();
|
||||||
|
const { edition } = useRulesEditionContext();
|
||||||
|
|
||||||
const breakdown = useDifficultyBreakdown();
|
const breakdown = useDifficultyBreakdown();
|
||||||
if (!breakdown) return null;
|
if (!breakdown) return null;
|
||||||
|
|
||||||
const tierConfig = TIER_LABELS[breakdown.tier];
|
const tierLabels = TIER_LABEL_MAP[edition];
|
||||||
|
if (!tierLabels) return null;
|
||||||
|
const tierConfig = tierLabels[breakdown.tier];
|
||||||
|
|
||||||
|
const handleToggle = (entry: BreakdownCombatant) => {
|
||||||
|
const newSide = entry.side === "party" ? "enemy" : "party";
|
||||||
|
setSide(entry.combatant.id, newSide);
|
||||||
|
};
|
||||||
|
|
||||||
|
const isPC = (entry: BreakdownCombatant) =>
|
||||||
|
entry.combatant.playerCharacterId != null;
|
||||||
|
|
||||||
return (
|
return (
|
||||||
<div
|
<div
|
||||||
ref={ref}
|
ref={ref}
|
||||||
className="absolute top-full right-0 z-50 mt-1 w-72 rounded-lg border border-border bg-card p-3 shadow-lg"
|
className="absolute top-full right-0 z-50 mt-1 w-80 rounded-lg border border-border bg-card p-3 shadow-lg max-sm:fixed max-sm:top-12 max-sm:right-3 max-sm:left-3 max-sm:w-auto"
|
||||||
>
|
>
|
||||||
<div className="mb-2 font-medium text-sm">
|
<div className="mb-2 font-medium text-sm">
|
||||||
Encounter Difficulty:{" "}
|
Encounter Difficulty:{" "}
|
||||||
@@ -75,35 +144,86 @@ export function DifficultyBreakdownPanel({ onClose }: { onClose: () => void }) {
|
|||||||
{breakdown.pcCount === 1 ? "PC" : "PCs"})
|
{breakdown.pcCount === 1 ? "PC" : "PCs"})
|
||||||
</div>
|
</div>
|
||||||
<div className="flex gap-3 text-xs">
|
<div className="flex gap-3 text-xs">
|
||||||
<span>
|
{breakdown.thresholds.map((t) => (
|
||||||
Low: <strong>{formatXp(breakdown.partyBudget.low)}</strong>
|
<span key={t.label}>
|
||||||
</span>
|
{shortLabel(t.label)}: <strong>{formatXp(t.value)}</strong>
|
||||||
<span>
|
|
||||||
Mod: <strong>{formatXp(breakdown.partyBudget.moderate)}</strong>
|
|
||||||
</span>
|
|
||||||
<span>
|
|
||||||
High: <strong>{formatXp(breakdown.partyBudget.high)}</strong>
|
|
||||||
</span>
|
</span>
|
||||||
|
))}
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
<div className="border-border border-t pt-2 pb-2 text-muted-foreground text-xs italic">
|
||||||
|
Allied NPC XP is subtracted from encounter difficulty
|
||||||
|
</div>
|
||||||
|
|
||||||
<div className="border-border border-t pt-2">
|
<div className="border-border border-t pt-2">
|
||||||
<div className="mb-1 flex justify-between text-muted-foreground text-xs">
|
<div className="mb-1 flex justify-between text-muted-foreground text-xs">
|
||||||
<span>Monsters</span>
|
<span>Party</span>
|
||||||
<span>XP</span>
|
<span>XP</span>
|
||||||
</div>
|
</div>
|
||||||
<div className="flex flex-col gap-1">
|
<div className="grid grid-cols-[1fr_auto_auto_3.5rem] gap-x-2 gap-y-1">
|
||||||
{breakdown.combatants.map((entry) => (
|
{breakdown.partyCombatants.map((entry) =>
|
||||||
<CombatantRow key={entry.combatant.id} entry={entry} />
|
isPC(entry) ? (
|
||||||
))}
|
<PcRow key={entry.combatant.id} entry={entry} />
|
||||||
|
) : (
|
||||||
|
<NpcRow
|
||||||
|
key={entry.combatant.id}
|
||||||
|
entry={entry}
|
||||||
|
onToggleSide={() => handleToggle(entry)}
|
||||||
|
/>
|
||||||
|
),
|
||||||
|
)}
|
||||||
</div>
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div className="mt-2 border-border border-t pt-2">
|
||||||
|
<div className="mb-1 flex justify-between text-muted-foreground text-xs">
|
||||||
|
<span>Enemy</span>
|
||||||
|
<span>XP</span>
|
||||||
|
</div>
|
||||||
|
<div className="grid grid-cols-[1fr_auto_auto_3.5rem] gap-x-2 gap-y-1">
|
||||||
|
{breakdown.enemyCombatants.map((entry) =>
|
||||||
|
isPC(entry) ? (
|
||||||
|
<PcRow key={entry.combatant.id} entry={entry} />
|
||||||
|
) : (
|
||||||
|
<NpcRow
|
||||||
|
key={entry.combatant.id}
|
||||||
|
entry={entry}
|
||||||
|
onToggleSide={() => handleToggle(entry)}
|
||||||
|
/>
|
||||||
|
),
|
||||||
|
)}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{breakdown.encounterMultiplier !== undefined &&
|
||||||
|
breakdown.adjustedXp !== undefined ? (
|
||||||
|
<div className="mt-2 border-border border-t pt-2">
|
||||||
|
<div className="flex justify-between font-medium text-xs">
|
||||||
|
<span>Monster XP</span>
|
||||||
|
<span className="tabular-nums">
|
||||||
|
{formatXp(breakdown.totalMonsterXp)}{" "}
|
||||||
|
<span className="text-muted-foreground">
|
||||||
|
×{breakdown.encounterMultiplier}
|
||||||
|
</span>{" "}
|
||||||
|
= {formatXp(breakdown.adjustedXp)}
|
||||||
|
</span>
|
||||||
|
</div>
|
||||||
|
{breakdown.partySizeAdjusted === true ? (
|
||||||
|
<div className="mt-0.5 text-muted-foreground text-xs italic">
|
||||||
|
Adjusted for {breakdown.pcCount}{" "}
|
||||||
|
{breakdown.pcCount === 1 ? "PC" : "PCs"}
|
||||||
|
</div>
|
||||||
|
) : null}
|
||||||
|
</div>
|
||||||
|
) : (
|
||||||
<div className="mt-2 flex justify-between border-border border-t pt-2 font-medium text-xs">
|
<div className="mt-2 flex justify-between border-border border-t pt-2 font-medium text-xs">
|
||||||
<span>Total Monster XP</span>
|
<span>Net Monster XP</span>
|
||||||
<span className="tabular-nums">
|
<span className="tabular-nums">
|
||||||
{formatXp(breakdown.totalMonsterXp)}
|
{formatXp(breakdown.totalMonsterXp)}
|
||||||
</span>
|
</span>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
)}
|
||||||
</div>
|
</div>
|
||||||
);
|
);
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,27 +1,44 @@
|
|||||||
import type { DifficultyResult, DifficultyTier } from "@initiative/domain";
|
import type { DifficultyResult, DifficultyTier } from "@initiative/domain";
|
||||||
import { cn } from "../lib/utils.js";
|
import { cn } from "../lib/utils.js";
|
||||||
|
|
||||||
const TIER_CONFIG: Record<
|
export const TIER_LABELS_5_5E: Record<DifficultyTier, string> = {
|
||||||
|
0: "Trivial",
|
||||||
|
1: "Low",
|
||||||
|
2: "Moderate",
|
||||||
|
3: "High",
|
||||||
|
};
|
||||||
|
|
||||||
|
export const TIER_LABELS_2014: Record<DifficultyTier, string> = {
|
||||||
|
0: "Easy",
|
||||||
|
1: "Medium",
|
||||||
|
2: "Hard",
|
||||||
|
3: "Deadly",
|
||||||
|
};
|
||||||
|
|
||||||
|
const TIER_COLORS: Record<
|
||||||
DifficultyTier,
|
DifficultyTier,
|
||||||
{ filledBars: number; color: string; label: string }
|
{ filledBars: number; color: string }
|
||||||
> = {
|
> = {
|
||||||
trivial: { filledBars: 0, color: "", label: "Trivial" },
|
0: { filledBars: 0, color: "" },
|
||||||
low: { filledBars: 1, color: "bg-green-500", label: "Low" },
|
1: { filledBars: 1, color: "bg-green-500" },
|
||||||
moderate: { filledBars: 2, color: "bg-yellow-500", label: "Moderate" },
|
2: { filledBars: 2, color: "bg-yellow-500" },
|
||||||
high: { filledBars: 3, color: "bg-red-500", label: "High" },
|
3: { filledBars: 3, color: "bg-red-500" },
|
||||||
};
|
};
|
||||||
|
|
||||||
const BAR_HEIGHTS = ["h-2", "h-3", "h-4"] as const;
|
const BAR_HEIGHTS = ["h-2", "h-3", "h-4"] as const;
|
||||||
|
|
||||||
export function DifficultyIndicator({
|
export function DifficultyIndicator({
|
||||||
result,
|
result,
|
||||||
|
labels,
|
||||||
onClick,
|
onClick,
|
||||||
}: {
|
}: {
|
||||||
result: DifficultyResult;
|
result: DifficultyResult;
|
||||||
|
labels: Record<DifficultyTier, string>;
|
||||||
onClick?: () => void;
|
onClick?: () => void;
|
||||||
}) {
|
}) {
|
||||||
const config = TIER_CONFIG[result.tier];
|
const config = TIER_COLORS[result.tier];
|
||||||
const tooltip = `${config.label} encounter difficulty`;
|
const label = labels[result.tier];
|
||||||
|
const tooltip = `${label} encounter difficulty`;
|
||||||
|
|
||||||
const Element = onClick ? "button" : "div";
|
const Element = onClick ? "button" : "div";
|
||||||
|
|
||||||
|
|||||||
@@ -1,10 +1,16 @@
|
|||||||
|
import type { Creature } from "@initiative/domain";
|
||||||
import {
|
import {
|
||||||
type Creature,
|
|
||||||
calculateInitiative,
|
calculateInitiative,
|
||||||
formatInitiativeModifier,
|
formatInitiativeModifier,
|
||||||
} from "@initiative/domain";
|
} from "@initiative/domain";
|
||||||
|
import {
|
||||||
|
PropertyLine,
|
||||||
|
SectionDivider,
|
||||||
|
TraitEntry,
|
||||||
|
TraitSection,
|
||||||
|
} from "./stat-block-parts.js";
|
||||||
|
|
||||||
interface StatBlockProps {
|
interface DndStatBlockProps {
|
||||||
creature: Creature;
|
creature: Creature;
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -13,53 +19,7 @@ function abilityMod(score: number): string {
|
|||||||
return mod >= 0 ? `+${mod}` : `${mod}`;
|
return mod >= 0 ? `+${mod}` : `${mod}`;
|
||||||
}
|
}
|
||||||
|
|
||||||
function PropertyLine({
|
export function DndStatBlock({ creature }: Readonly<DndStatBlockProps>) {
|
||||||
label,
|
|
||||||
value,
|
|
||||||
}: Readonly<{
|
|
||||||
label: string;
|
|
||||||
value: string | undefined;
|
|
||||||
}>) {
|
|
||||||
if (!value) return null;
|
|
||||||
return (
|
|
||||||
<div className="text-sm">
|
|
||||||
<span className="font-semibold">{label}</span> {value}
|
|
||||||
</div>
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
function SectionDivider() {
|
|
||||||
return (
|
|
||||||
<div className="my-2 h-px bg-gradient-to-r from-stat-divider-from via-stat-divider-via to-transparent" />
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
function TraitSection({
|
|
||||||
entries,
|
|
||||||
heading,
|
|
||||||
}: Readonly<{
|
|
||||||
entries: readonly { name: string; text: string }[] | undefined;
|
|
||||||
heading?: string;
|
|
||||||
}>) {
|
|
||||||
if (!entries || entries.length === 0) return null;
|
|
||||||
return (
|
|
||||||
<>
|
|
||||||
<SectionDivider />
|
|
||||||
{heading ? (
|
|
||||||
<h3 className="font-bold text-base text-stat-heading">{heading}</h3>
|
|
||||||
) : null}
|
|
||||||
<div className="space-y-2">
|
|
||||||
{entries.map((e) => (
|
|
||||||
<div key={e.name} className="text-sm">
|
|
||||||
<span className="font-semibold italic">{e.name}.</span> {e.text}
|
|
||||||
</div>
|
|
||||||
))}
|
|
||||||
</div>
|
|
||||||
</>
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
export function StatBlock({ creature }: Readonly<StatBlockProps>) {
|
|
||||||
const abilities = [
|
const abilities = [
|
||||||
{ label: "STR", score: creature.abilities.str },
|
{ label: "STR", score: creature.abilities.str },
|
||||||
{ label: "DEX", score: creature.abilities.dex },
|
{ label: "DEX", score: creature.abilities.dex },
|
||||||
@@ -219,9 +179,7 @@ export function StatBlock({ creature }: Readonly<StatBlockProps>) {
|
|||||||
</p>
|
</p>
|
||||||
<div className="space-y-2">
|
<div className="space-y-2">
|
||||||
{creature.legendaryActions.entries.map((a) => (
|
{creature.legendaryActions.entries.map((a) => (
|
||||||
<div key={a.name} className="text-sm">
|
<TraitEntry key={a.name} trait={a} />
|
||||||
<span className="font-semibold italic">{a.name}.</span> {a.text}
|
|
||||||
</div>
|
|
||||||
))}
|
))}
|
||||||
</div>
|
</div>
|
||||||
</>
|
</>
|
||||||
143
apps/web/src/components/pf2e-stat-block.tsx
Normal file
143
apps/web/src/components/pf2e-stat-block.tsx
Normal file
@@ -0,0 +1,143 @@
|
|||||||
|
import type { Pf2eCreature } from "@initiative/domain";
|
||||||
|
import { formatInitiativeModifier } from "@initiative/domain";
|
||||||
|
import {
|
||||||
|
PropertyLine,
|
||||||
|
SectionDivider,
|
||||||
|
TraitSection,
|
||||||
|
} from "./stat-block-parts.js";
|
||||||
|
|
||||||
|
interface Pf2eStatBlockProps {
|
||||||
|
creature: Pf2eCreature;
|
||||||
|
}
|
||||||
|
|
||||||
|
const ALIGNMENTS = new Set([
|
||||||
|
"lg",
|
||||||
|
"ng",
|
||||||
|
"cg",
|
||||||
|
"ln",
|
||||||
|
"n",
|
||||||
|
"cn",
|
||||||
|
"le",
|
||||||
|
"ne",
|
||||||
|
"ce",
|
||||||
|
]);
|
||||||
|
|
||||||
|
function capitalize(s: string): string {
|
||||||
|
return s.charAt(0).toUpperCase() + s.slice(1);
|
||||||
|
}
|
||||||
|
|
||||||
|
function displayTraits(traits: readonly string[]): string[] {
|
||||||
|
return traits.filter((t) => !ALIGNMENTS.has(t)).map(capitalize);
|
||||||
|
}
|
||||||
|
|
||||||
|
function formatMod(mod: number): string {
|
||||||
|
return mod >= 0 ? `+${mod}` : `${mod}`;
|
||||||
|
}
|
||||||
|
|
||||||
|
export function Pf2eStatBlock({ creature }: Readonly<Pf2eStatBlockProps>) {
|
||||||
|
const abilityEntries = [
|
||||||
|
{ label: "Str", mod: creature.abilityMods.str },
|
||||||
|
{ label: "Dex", mod: creature.abilityMods.dex },
|
||||||
|
{ label: "Con", mod: creature.abilityMods.con },
|
||||||
|
{ label: "Int", mod: creature.abilityMods.int },
|
||||||
|
{ label: "Wis", mod: creature.abilityMods.wis },
|
||||||
|
{ label: "Cha", mod: creature.abilityMods.cha },
|
||||||
|
];
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className="space-y-1 text-foreground">
|
||||||
|
{/* Header */}
|
||||||
|
<div>
|
||||||
|
<div className="flex items-baseline justify-between gap-2">
|
||||||
|
<h2 className="font-bold text-stat-heading text-xl">
|
||||||
|
{creature.name}
|
||||||
|
</h2>
|
||||||
|
<span className="shrink-0 font-semibold text-sm">
|
||||||
|
Level {creature.level}
|
||||||
|
</span>
|
||||||
|
</div>
|
||||||
|
<div className="mt-1 flex flex-wrap gap-1">
|
||||||
|
{displayTraits(creature.traits).map((trait) => (
|
||||||
|
<span
|
||||||
|
key={trait}
|
||||||
|
className="rounded border border-border bg-card px-1.5 py-0.5 text-foreground text-xs"
|
||||||
|
>
|
||||||
|
{trait}
|
||||||
|
</span>
|
||||||
|
))}
|
||||||
|
</div>
|
||||||
|
<p className="mt-1 text-muted-foreground text-xs">
|
||||||
|
{creature.sourceDisplayName}
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<SectionDivider />
|
||||||
|
|
||||||
|
{/* Perception, Languages, Skills */}
|
||||||
|
<div className="space-y-0.5 text-sm">
|
||||||
|
<div>
|
||||||
|
<span className="font-semibold">Perception</span>{" "}
|
||||||
|
{formatInitiativeModifier(creature.perception)}
|
||||||
|
{creature.senses ? `; ${creature.senses}` : ""}
|
||||||
|
</div>
|
||||||
|
<PropertyLine label="Languages" value={creature.languages} />
|
||||||
|
<PropertyLine label="Skills" value={creature.skills} />
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* Ability Modifiers */}
|
||||||
|
<div className="grid grid-cols-6 gap-1 text-center text-sm">
|
||||||
|
{abilityEntries.map((a) => (
|
||||||
|
<div key={a.label}>
|
||||||
|
<div className="font-semibold text-muted-foreground text-xs">
|
||||||
|
{a.label}
|
||||||
|
</div>
|
||||||
|
<div>{formatMod(a.mod)}</div>
|
||||||
|
</div>
|
||||||
|
))}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<PropertyLine label="Items" value={creature.items} />
|
||||||
|
|
||||||
|
{/* Top abilities (before defenses) */}
|
||||||
|
<TraitSection entries={creature.abilitiesTop} />
|
||||||
|
|
||||||
|
<SectionDivider />
|
||||||
|
|
||||||
|
{/* Defenses */}
|
||||||
|
<div className="space-y-0.5 text-sm">
|
||||||
|
<div>
|
||||||
|
<span className="font-semibold">AC</span> {creature.ac}
|
||||||
|
{creature.acConditional ? ` (${creature.acConditional})` : ""};{" "}
|
||||||
|
<span className="font-semibold">Fort</span>{" "}
|
||||||
|
{formatMod(creature.saveFort)},{" "}
|
||||||
|
<span className="font-semibold">Ref</span>{" "}
|
||||||
|
{formatMod(creature.saveRef)},{" "}
|
||||||
|
<span className="font-semibold">Will</span>{" "}
|
||||||
|
{formatMod(creature.saveWill)}
|
||||||
|
</div>
|
||||||
|
<div>
|
||||||
|
<span className="font-semibold">HP</span> {creature.hp}
|
||||||
|
</div>
|
||||||
|
<PropertyLine label="Immunities" value={creature.immunities} />
|
||||||
|
<PropertyLine label="Resistances" value={creature.resistances} />
|
||||||
|
<PropertyLine label="Weaknesses" value={creature.weaknesses} />
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* Mid abilities (reactions, auras) */}
|
||||||
|
<TraitSection entries={creature.abilitiesMid} />
|
||||||
|
|
||||||
|
<SectionDivider />
|
||||||
|
|
||||||
|
{/* Speed */}
|
||||||
|
<div className="text-sm">
|
||||||
|
<span className="font-semibold">Speed</span> {creature.speed}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{/* Attacks */}
|
||||||
|
<TraitSection entries={creature.attacks} />
|
||||||
|
|
||||||
|
{/* Bottom abilities (active abilities) */}
|
||||||
|
<TraitSection entries={creature.abilitiesBot} />
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
@@ -13,6 +13,7 @@ interface SettingsModalProps {
|
|||||||
const EDITION_OPTIONS: { value: RulesEdition; label: string }[] = [
|
const EDITION_OPTIONS: { value: RulesEdition; label: string }[] = [
|
||||||
{ value: "5e", label: "5e (2014)" },
|
{ value: "5e", label: "5e (2014)" },
|
||||||
{ value: "5.5e", label: "5.5e (2024)" },
|
{ value: "5.5e", label: "5.5e (2024)" },
|
||||||
|
{ value: "pf2e", label: "Pathfinder 2e" },
|
||||||
];
|
];
|
||||||
|
|
||||||
const THEME_OPTIONS: {
|
const THEME_OPTIONS: {
|
||||||
@@ -36,7 +37,7 @@ export function SettingsModal({ open, onClose }: Readonly<SettingsModalProps>) {
|
|||||||
<div className="flex flex-col gap-5">
|
<div className="flex flex-col gap-5">
|
||||||
<div>
|
<div>
|
||||||
<span className="mb-2 block font-medium text-muted-foreground text-sm">
|
<span className="mb-2 block font-medium text-muted-foreground text-sm">
|
||||||
Conditions
|
Game System
|
||||||
</span>
|
</span>
|
||||||
<div className="flex gap-1">
|
<div className="flex gap-1">
|
||||||
{EDITION_OPTIONS.map((opt) => (
|
{EDITION_OPTIONS.map((opt) => (
|
||||||
|
|||||||
@@ -2,6 +2,7 @@ import { Download, Loader2, Upload } from "lucide-react";
|
|||||||
import { useId, useRef, useState } from "react";
|
import { useId, useRef, useState } from "react";
|
||||||
import { useAdapters } from "../contexts/adapter-context.js";
|
import { useAdapters } from "../contexts/adapter-context.js";
|
||||||
import { useBestiaryContext } from "../contexts/bestiary-context.js";
|
import { useBestiaryContext } from "../contexts/bestiary-context.js";
|
||||||
|
import { useRulesEditionContext } from "../contexts/rules-edition-context.js";
|
||||||
import { Button } from "./ui/button.js";
|
import { Button } from "./ui/button.js";
|
||||||
import { Input } from "./ui/input.js";
|
import { Input } from "./ui/input.js";
|
||||||
|
|
||||||
@@ -14,11 +15,13 @@ export function SourceFetchPrompt({
|
|||||||
sourceCode,
|
sourceCode,
|
||||||
onSourceLoaded,
|
onSourceLoaded,
|
||||||
}: Readonly<SourceFetchPromptProps>) {
|
}: Readonly<SourceFetchPromptProps>) {
|
||||||
const { bestiaryIndex } = useAdapters();
|
const { bestiaryIndex, pf2eBestiaryIndex } = useAdapters();
|
||||||
const { fetchAndCacheSource, uploadAndCacheSource } = useBestiaryContext();
|
const { fetchAndCacheSource, uploadAndCacheSource } = useBestiaryContext();
|
||||||
const sourceDisplayName = bestiaryIndex.getSourceDisplayName(sourceCode);
|
const { edition } = useRulesEditionContext();
|
||||||
|
const indexPort = edition === "pf2e" ? pf2eBestiaryIndex : bestiaryIndex;
|
||||||
|
const sourceDisplayName = indexPort.getSourceDisplayName(sourceCode);
|
||||||
const [url, setUrl] = useState(() =>
|
const [url, setUrl] = useState(() =>
|
||||||
bestiaryIndex.getDefaultFetchUrl(sourceCode),
|
indexPort.getDefaultFetchUrl(sourceCode),
|
||||||
);
|
);
|
||||||
const [status, setStatus] = useState<"idle" | "fetching" | "error">("idle");
|
const [status, setStatus] = useState<"idle" | "fetching" | "error">("idle");
|
||||||
const [error, setError] = useState<string>("");
|
const [error, setError] = useState<string>("");
|
||||||
|
|||||||
@@ -9,12 +9,15 @@ import {
|
|||||||
import type { CachedSourceInfo } from "../adapters/ports.js";
|
import type { CachedSourceInfo } from "../adapters/ports.js";
|
||||||
import { useAdapters } from "../contexts/adapter-context.js";
|
import { useAdapters } from "../contexts/adapter-context.js";
|
||||||
import { useBestiaryContext } from "../contexts/bestiary-context.js";
|
import { useBestiaryContext } from "../contexts/bestiary-context.js";
|
||||||
|
import { useRulesEditionContext } from "../contexts/rules-edition-context.js";
|
||||||
import { Button } from "./ui/button.js";
|
import { Button } from "./ui/button.js";
|
||||||
import { Input } from "./ui/input.js";
|
import { Input } from "./ui/input.js";
|
||||||
|
|
||||||
export function SourceManager() {
|
export function SourceManager() {
|
||||||
const { bestiaryCache } = useAdapters();
|
const { bestiaryCache } = useAdapters();
|
||||||
const { refreshCache } = useBestiaryContext();
|
const { refreshCache } = useBestiaryContext();
|
||||||
|
const { edition } = useRulesEditionContext();
|
||||||
|
const system = edition === "pf2e" ? "pf2e" : "dnd";
|
||||||
const [sources, setSources] = useState<CachedSourceInfo[]>([]);
|
const [sources, setSources] = useState<CachedSourceInfo[]>([]);
|
||||||
const [filter, setFilter] = useState("");
|
const [filter, setFilter] = useState("");
|
||||||
const [optimisticSources, applyOptimistic] = useOptimistic(
|
const [optimisticSources, applyOptimistic] = useOptimistic(
|
||||||
@@ -29,9 +32,9 @@ export function SourceManager() {
|
|||||||
);
|
);
|
||||||
|
|
||||||
const loadSources = useCallback(async () => {
|
const loadSources = useCallback(async () => {
|
||||||
const cached = await bestiaryCache.getCachedSources();
|
const cached = await bestiaryCache.getCachedSources(system);
|
||||||
setSources(cached);
|
setSources(cached);
|
||||||
}, [bestiaryCache]);
|
}, [bestiaryCache, system]);
|
||||||
|
|
||||||
useEffect(() => {
|
useEffect(() => {
|
||||||
void loadSources();
|
void loadSources();
|
||||||
@@ -39,7 +42,7 @@ export function SourceManager() {
|
|||||||
|
|
||||||
const handleClearSource = async (sourceCode: string) => {
|
const handleClearSource = async (sourceCode: string) => {
|
||||||
applyOptimistic({ type: "remove", sourceCode });
|
applyOptimistic({ type: "remove", sourceCode });
|
||||||
await bestiaryCache.clearSource(sourceCode);
|
await bestiaryCache.clearSource(system, sourceCode);
|
||||||
await loadSources();
|
await loadSources();
|
||||||
void refreshCache();
|
void refreshCache();
|
||||||
};
|
};
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
import type { CreatureId } from "@initiative/domain";
|
import type { Creature, CreatureId } from "@initiative/domain";
|
||||||
import { PanelRightClose, Pin, PinOff } from "lucide-react";
|
import { PanelRightClose, Pin, PinOff } from "lucide-react";
|
||||||
import type { ReactNode } from "react";
|
import type { ReactNode } from "react";
|
||||||
import { useEffect, useState } from "react";
|
import { useEffect, useState } from "react";
|
||||||
@@ -7,9 +7,10 @@ import { useSidePanelContext } from "../contexts/side-panel-context.js";
|
|||||||
import { useSwipeToDismiss } from "../hooks/use-swipe-to-dismiss.js";
|
import { useSwipeToDismiss } from "../hooks/use-swipe-to-dismiss.js";
|
||||||
import { cn } from "../lib/utils.js";
|
import { cn } from "../lib/utils.js";
|
||||||
import { BulkImportPrompt } from "./bulk-import-prompt.js";
|
import { BulkImportPrompt } from "./bulk-import-prompt.js";
|
||||||
|
import { DndStatBlock } from "./dnd-stat-block.js";
|
||||||
|
import { Pf2eStatBlock } from "./pf2e-stat-block.js";
|
||||||
import { SourceFetchPrompt } from "./source-fetch-prompt.js";
|
import { SourceFetchPrompt } from "./source-fetch-prompt.js";
|
||||||
import { SourceManager } from "./source-manager.js";
|
import { SourceManager } from "./source-manager.js";
|
||||||
import { StatBlock } from "./stat-block.js";
|
|
||||||
import { Button } from "./ui/button.js";
|
import { Button } from "./ui/button.js";
|
||||||
|
|
||||||
interface StatBlockPanelProps {
|
interface StatBlockPanelProps {
|
||||||
@@ -307,7 +308,10 @@ export function StatBlockPanel({
|
|||||||
}
|
}
|
||||||
|
|
||||||
if (creature) {
|
if (creature) {
|
||||||
return <StatBlock creature={creature} />;
|
if ("system" in creature && creature.system === "pf2e") {
|
||||||
|
return <Pf2eStatBlock creature={creature} />;
|
||||||
|
}
|
||||||
|
return <DndStatBlock creature={creature as Creature} />;
|
||||||
}
|
}
|
||||||
|
|
||||||
if (needsFetch && sourceCode) {
|
if (needsFetch && sourceCode) {
|
||||||
|
|||||||
90
apps/web/src/components/stat-block-parts.tsx
Normal file
90
apps/web/src/components/stat-block-parts.tsx
Normal file
@@ -0,0 +1,90 @@
|
|||||||
|
import type { TraitBlock, TraitSegment } from "@initiative/domain";
|
||||||
|
|
||||||
|
export function PropertyLine({
|
||||||
|
label,
|
||||||
|
value,
|
||||||
|
}: Readonly<{
|
||||||
|
label: string;
|
||||||
|
value: string | undefined;
|
||||||
|
}>) {
|
||||||
|
if (!value) return null;
|
||||||
|
return (
|
||||||
|
<div className="text-sm">
|
||||||
|
<span className="font-semibold">{label}</span> {value}
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
export function SectionDivider() {
|
||||||
|
return (
|
||||||
|
<div className="my-2 h-px bg-gradient-to-r from-stat-divider-from via-stat-divider-via to-transparent" />
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
function segmentKey(seg: TraitSegment): string {
|
||||||
|
return seg.type === "text"
|
||||||
|
? seg.value.slice(0, 40)
|
||||||
|
: seg.items.map((i) => i.label ?? i.text.slice(0, 20)).join(",");
|
||||||
|
}
|
||||||
|
|
||||||
|
function TraitSegments({
|
||||||
|
segments,
|
||||||
|
}: Readonly<{ segments: readonly TraitSegment[] }>) {
|
||||||
|
return (
|
||||||
|
<>
|
||||||
|
{segments.map((seg, i) => {
|
||||||
|
if (seg.type === "text") {
|
||||||
|
return (
|
||||||
|
<span key={segmentKey(seg)}>
|
||||||
|
{i === 0 ? ` ${seg.value}` : seg.value}
|
||||||
|
</span>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
return (
|
||||||
|
<div key={segmentKey(seg)} className="mt-1 space-y-0.5">
|
||||||
|
{seg.items.map((item) => (
|
||||||
|
<p key={item.label ?? item.text}>
|
||||||
|
{item.label != null && (
|
||||||
|
<span className="font-semibold">{item.label}. </span>
|
||||||
|
)}
|
||||||
|
{item.text}
|
||||||
|
</p>
|
||||||
|
))}
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
})}
|
||||||
|
</>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
export function TraitEntry({ trait }: Readonly<{ trait: TraitBlock }>) {
|
||||||
|
return (
|
||||||
|
<div className="text-sm">
|
||||||
|
<span className="font-semibold italic">{trait.name}.</span>
|
||||||
|
<TraitSegments segments={trait.segments} />
|
||||||
|
</div>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
export function TraitSection({
|
||||||
|
entries,
|
||||||
|
heading,
|
||||||
|
}: Readonly<{
|
||||||
|
entries: readonly TraitBlock[] | undefined;
|
||||||
|
heading?: string;
|
||||||
|
}>) {
|
||||||
|
if (!entries || entries.length === 0) return null;
|
||||||
|
return (
|
||||||
|
<>
|
||||||
|
<SectionDivider />
|
||||||
|
{heading ? (
|
||||||
|
<h3 className="font-bold text-base text-stat-heading">{heading}</h3>
|
||||||
|
) : null}
|
||||||
|
<div className="space-y-2">
|
||||||
|
{entries.map((e) => (
|
||||||
|
<TraitEntry key={e.name} trait={e} />
|
||||||
|
))}
|
||||||
|
</div>
|
||||||
|
</>
|
||||||
|
);
|
||||||
|
}
|
||||||
@@ -1,9 +1,14 @@
|
|||||||
import { Redo2, StepBack, StepForward, Trash2, Undo2 } from "lucide-react";
|
import { Redo2, StepBack, StepForward, Trash2, Undo2 } from "lucide-react";
|
||||||
import { useState } from "react";
|
import { useState } from "react";
|
||||||
import { useEncounterContext } from "../contexts/encounter-context.js";
|
import { useEncounterContext } from "../contexts/encounter-context.js";
|
||||||
|
import { useRulesEditionContext } from "../contexts/rules-edition-context.js";
|
||||||
import { useDifficulty } from "../hooks/use-difficulty.js";
|
import { useDifficulty } from "../hooks/use-difficulty.js";
|
||||||
import { DifficultyBreakdownPanel } from "./difficulty-breakdown-panel.js";
|
import { DifficultyBreakdownPanel } from "./difficulty-breakdown-panel.js";
|
||||||
import { DifficultyIndicator } from "./difficulty-indicator.js";
|
import {
|
||||||
|
DifficultyIndicator,
|
||||||
|
TIER_LABELS_5_5E,
|
||||||
|
TIER_LABELS_2014,
|
||||||
|
} from "./difficulty-indicator.js";
|
||||||
import { Button } from "./ui/button.js";
|
import { Button } from "./ui/button.js";
|
||||||
import { ConfirmButton } from "./ui/confirm-button.js";
|
import { ConfirmButton } from "./ui/confirm-button.js";
|
||||||
|
|
||||||
@@ -20,6 +25,8 @@ export function TurnNavigation() {
|
|||||||
} = useEncounterContext();
|
} = useEncounterContext();
|
||||||
|
|
||||||
const difficulty = useDifficulty();
|
const difficulty = useDifficulty();
|
||||||
|
const { edition } = useRulesEditionContext();
|
||||||
|
const tierLabels = edition === "5e" ? TIER_LABELS_2014 : TIER_LABELS_5_5E;
|
||||||
const [showBreakdown, setShowBreakdown] = useState(false);
|
const [showBreakdown, setShowBreakdown] = useState(false);
|
||||||
const hasCombatants = encounter.combatants.length > 0;
|
const hasCombatants = encounter.combatants.length > 0;
|
||||||
const isAtStart = encounter.roundNumber === 1 && encounter.activeIndex === 0;
|
const isAtStart = encounter.roundNumber === 1 && encounter.activeIndex === 0;
|
||||||
@@ -79,6 +86,7 @@ export function TurnNavigation() {
|
|||||||
<div className="relative mr-1">
|
<div className="relative mr-1">
|
||||||
<DifficultyIndicator
|
<DifficultyIndicator
|
||||||
result={difficulty}
|
result={difficulty}
|
||||||
|
labels={tierLabels}
|
||||||
onClick={() => setShowBreakdown((prev) => !prev)}
|
onClick={() => setShowBreakdown((prev) => !prev)}
|
||||||
/>
|
/>
|
||||||
{showBreakdown ? (
|
{showBreakdown ? (
|
||||||
|
|||||||
@@ -3,6 +3,7 @@ import type {
|
|||||||
BestiaryCachePort,
|
BestiaryCachePort,
|
||||||
BestiaryIndexPort,
|
BestiaryIndexPort,
|
||||||
EncounterPersistence,
|
EncounterPersistence,
|
||||||
|
Pf2eBestiaryIndexPort,
|
||||||
PlayerCharacterPersistence,
|
PlayerCharacterPersistence,
|
||||||
UndoRedoPersistence,
|
UndoRedoPersistence,
|
||||||
} from "../adapters/ports.js";
|
} from "../adapters/ports.js";
|
||||||
@@ -13,6 +14,7 @@ export interface Adapters {
|
|||||||
playerCharacterPersistence: PlayerCharacterPersistence;
|
playerCharacterPersistence: PlayerCharacterPersistence;
|
||||||
bestiaryCache: BestiaryCachePort;
|
bestiaryCache: BestiaryCachePort;
|
||||||
bestiaryIndex: BestiaryIndexPort;
|
bestiaryIndex: BestiaryIndexPort;
|
||||||
|
pf2eBestiaryIndex: Pf2eBestiaryIndexPort;
|
||||||
}
|
}
|
||||||
|
|
||||||
const AdapterContext = createContext<Adapters | null>(null);
|
const AdapterContext = createContext<Adapters | null>(null);
|
||||||
|
|||||||
@@ -1,8 +1,4 @@
|
|||||||
import type {
|
import type { ConditionId, PlayerCharacter } from "@initiative/domain";
|
||||||
BestiaryIndexEntry,
|
|
||||||
ConditionId,
|
|
||||||
PlayerCharacter,
|
|
||||||
} from "@initiative/domain";
|
|
||||||
import {
|
import {
|
||||||
combatantId,
|
combatantId,
|
||||||
createEncounter,
|
createEncounter,
|
||||||
@@ -11,6 +7,7 @@ import {
|
|||||||
playerCharacterId,
|
playerCharacterId,
|
||||||
} from "@initiative/domain";
|
} from "@initiative/domain";
|
||||||
import { describe, expect, it } from "vitest";
|
import { describe, expect, it } from "vitest";
|
||||||
|
import type { SearchResult } from "../use-bestiary.js";
|
||||||
import { type EncounterState, encounterReducer } from "../use-encounter.js";
|
import { type EncounterState, encounterReducer } from "../use-encounter.js";
|
||||||
|
|
||||||
function emptyState(): EncounterState {
|
function emptyState(): EncounterState {
|
||||||
@@ -45,9 +42,11 @@ function stateWithHp(name: string, maxHp: number): EncounterState {
|
|||||||
});
|
});
|
||||||
}
|
}
|
||||||
|
|
||||||
const BESTIARY_ENTRY: BestiaryIndexEntry = {
|
const BESTIARY_ENTRY: SearchResult = {
|
||||||
|
system: "dnd",
|
||||||
name: "Goblin",
|
name: "Goblin",
|
||||||
source: "MM",
|
source: "MM",
|
||||||
|
sourceDisplayName: "Monster Manual",
|
||||||
ac: 15,
|
ac: 15,
|
||||||
hp: 7,
|
hp: 7,
|
||||||
dex: 14,
|
dex: 14,
|
||||||
@@ -57,6 +56,19 @@ const BESTIARY_ENTRY: BestiaryIndexEntry = {
|
|||||||
type: "humanoid",
|
type: "humanoid",
|
||||||
};
|
};
|
||||||
|
|
||||||
|
const PF2E_BESTIARY_ENTRY: SearchResult = {
|
||||||
|
system: "pf2e",
|
||||||
|
name: "Goblin Warrior",
|
||||||
|
source: "B1",
|
||||||
|
sourceDisplayName: "Bestiary",
|
||||||
|
level: -1,
|
||||||
|
ac: 16,
|
||||||
|
hp: 6,
|
||||||
|
perception: 5,
|
||||||
|
size: "small",
|
||||||
|
type: "humanoid",
|
||||||
|
};
|
||||||
|
|
||||||
describe("encounterReducer", () => {
|
describe("encounterReducer", () => {
|
||||||
describe("add-combatant", () => {
|
describe("add-combatant", () => {
|
||||||
it("adds a combatant and pushes undo", () => {
|
it("adds a combatant and pushes undo", () => {
|
||||||
@@ -236,7 +248,9 @@ describe("encounterReducer", () => {
|
|||||||
conditionId: "blinded" as ConditionId,
|
conditionId: "blinded" as ConditionId,
|
||||||
});
|
});
|
||||||
|
|
||||||
expect(next.encounter.combatants[0].conditions).toContain("blinded");
|
expect(next.encounter.combatants[0].conditions).toContainEqual({
|
||||||
|
id: "blinded",
|
||||||
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
it("toggles concentration", () => {
|
it("toggles concentration", () => {
|
||||||
@@ -327,6 +341,19 @@ describe("encounterReducer", () => {
|
|||||||
expect(names).toContain("Goblin 1");
|
expect(names).toContain("Goblin 1");
|
||||||
expect(names).toContain("Goblin 2");
|
expect(names).toContain("Goblin 2");
|
||||||
});
|
});
|
||||||
|
|
||||||
|
it("adds PF2e creature with HP, AC, and creatureId", () => {
|
||||||
|
const next = encounterReducer(emptyState(), {
|
||||||
|
type: "add-from-bestiary",
|
||||||
|
entry: PF2E_BESTIARY_ENTRY,
|
||||||
|
});
|
||||||
|
|
||||||
|
const c = next.encounter.combatants[0];
|
||||||
|
expect(c.name).toBe("Goblin Warrior");
|
||||||
|
expect(c.maxHp).toBe(6);
|
||||||
|
expect(c.ac).toBe(16);
|
||||||
|
expect(c.creatureId).toBe("b1:goblin-warrior");
|
||||||
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
describe("add-multiple-from-bestiary", () => {
|
describe("add-multiple-from-bestiary", () => {
|
||||||
|
|||||||
@@ -12,6 +12,7 @@ import {
|
|||||||
} from "../../__tests__/factories/index.js";
|
} from "../../__tests__/factories/index.js";
|
||||||
import { AllProviders } from "../../__tests__/test-providers.js";
|
import { AllProviders } from "../../__tests__/test-providers.js";
|
||||||
import { useDifficultyBreakdown } from "../use-difficulty-breakdown.js";
|
import { useDifficultyBreakdown } from "../use-difficulty-breakdown.js";
|
||||||
|
import { useRulesEdition } from "../use-rules-edition.js";
|
||||||
|
|
||||||
beforeAll(() => {
|
beforeAll(() => {
|
||||||
Object.defineProperty(globalThis, "matchMedia", {
|
Object.defineProperty(globalThis, "matchMedia", {
|
||||||
@@ -106,7 +107,7 @@ describe("useDifficultyBreakdown", () => {
|
|||||||
expect(result.current).toBeNull();
|
expect(result.current).toBeNull();
|
||||||
});
|
});
|
||||||
|
|
||||||
it("returns per-combatant entries with correct data", async () => {
|
it("returns per-combatant entries split by side", async () => {
|
||||||
const wrapper = makeWrapper({
|
const wrapper = makeWrapper({
|
||||||
encounter: buildEncounter({
|
encounter: buildEncounter({
|
||||||
combatants: [
|
combatants: [
|
||||||
@@ -145,29 +146,34 @@ describe("useDifficultyBreakdown", () => {
|
|||||||
const breakdown = result.current;
|
const breakdown = result.current;
|
||||||
expect(breakdown).not.toBeNull();
|
expect(breakdown).not.toBeNull();
|
||||||
expect(breakdown?.pcCount).toBe(1);
|
expect(breakdown?.pcCount).toBe(1);
|
||||||
// CR 1/4 = 50 + CR 2 = 450 → total 500
|
// CR 1/4 = 50 + CR 2 = 450 -> total 500
|
||||||
expect(breakdown?.totalMonsterXp).toBe(500);
|
expect(breakdown?.totalMonsterXp).toBe(500);
|
||||||
expect(breakdown?.combatants).toHaveLength(3);
|
|
||||||
|
|
||||||
// Bestiary combatant
|
// PC in party column
|
||||||
const goblin = breakdown?.combatants[0];
|
expect(breakdown?.partyCombatants).toHaveLength(1);
|
||||||
|
expect(breakdown?.partyCombatants[0].combatant.name).toBe("Hero");
|
||||||
|
expect(breakdown?.partyCombatants[0].side).toBe("party");
|
||||||
|
expect(breakdown?.partyCombatants[0].level).toBe(5);
|
||||||
|
|
||||||
|
// Enemies: goblin, thug, bandit
|
||||||
|
expect(breakdown?.enemyCombatants).toHaveLength(3);
|
||||||
|
|
||||||
|
const goblin = breakdown?.enemyCombatants[0];
|
||||||
expect(goblin?.cr).toBe("1/4");
|
expect(goblin?.cr).toBe("1/4");
|
||||||
expect(goblin?.xp).toBe(50);
|
expect(goblin?.xp).toBe(50);
|
||||||
expect(goblin?.source).toBe("SRD");
|
expect(goblin?.source).toBe("SRD");
|
||||||
expect(goblin?.editable).toBe(false);
|
expect(goblin?.editable).toBe(false);
|
||||||
|
expect(goblin?.side).toBe("enemy");
|
||||||
|
|
||||||
// Custom with CR
|
const thug = breakdown?.enemyCombatants[1];
|
||||||
const thug = breakdown?.combatants[1];
|
|
||||||
expect(thug?.cr).toBe("2");
|
expect(thug?.cr).toBe("2");
|
||||||
expect(thug?.xp).toBe(450);
|
expect(thug?.xp).toBe(450);
|
||||||
expect(thug?.source).toBeNull();
|
expect(thug?.source).toBeNull();
|
||||||
expect(thug?.editable).toBe(true);
|
expect(thug?.editable).toBe(true);
|
||||||
|
|
||||||
// Custom without CR
|
const bandit = breakdown?.enemyCombatants[2];
|
||||||
const bandit = breakdown?.combatants[2];
|
|
||||||
expect(bandit?.cr).toBeNull();
|
expect(bandit?.cr).toBeNull();
|
||||||
expect(bandit?.xp).toBeNull();
|
expect(bandit?.xp).toBeNull();
|
||||||
expect(bandit?.source).toBeNull();
|
|
||||||
expect(bandit?.editable).toBe(true);
|
expect(bandit?.editable).toBe(true);
|
||||||
});
|
});
|
||||||
});
|
});
|
||||||
@@ -203,16 +209,15 @@ describe("useDifficultyBreakdown", () => {
|
|||||||
wrapper,
|
wrapper,
|
||||||
});
|
});
|
||||||
|
|
||||||
// With no bestiary creatures loaded, the Ghost has null CR
|
|
||||||
const breakdown = result.current;
|
const breakdown = result.current;
|
||||||
expect(breakdown).not.toBeNull();
|
expect(breakdown).not.toBeNull();
|
||||||
const ghost = breakdown?.combatants[0];
|
const ghost = breakdown?.enemyCombatants[0];
|
||||||
expect(ghost?.cr).toBeNull();
|
expect(ghost?.cr).toBeNull();
|
||||||
expect(ghost?.xp).toBeNull();
|
expect(ghost?.xp).toBeNull();
|
||||||
expect(ghost?.editable).toBe(false);
|
expect(ghost?.editable).toBe(false);
|
||||||
});
|
});
|
||||||
|
|
||||||
it("excludes PC combatants from breakdown entries", async () => {
|
it("PC combatants appear in partyCombatants with level", async () => {
|
||||||
const wrapper = makeWrapper({
|
const wrapper = makeWrapper({
|
||||||
encounter: buildEncounter({
|
encounter: buildEncounter({
|
||||||
combatants: [
|
combatants: [
|
||||||
@@ -239,8 +244,105 @@ describe("useDifficultyBreakdown", () => {
|
|||||||
});
|
});
|
||||||
|
|
||||||
await waitFor(() => {
|
await waitFor(() => {
|
||||||
expect(result.current?.combatants).toHaveLength(1);
|
expect(result.current?.partyCombatants).toHaveLength(1);
|
||||||
expect(result.current?.combatants[0].combatant.name).toBe("Goblin");
|
expect(result.current?.partyCombatants[0].combatant.name).toBe("Hero");
|
||||||
|
expect(result.current?.partyCombatants[0].level).toBe(1);
|
||||||
|
expect(result.current?.partyCombatants[0].side).toBe("party");
|
||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
|
it("combatant with explicit side override is placed correctly", () => {
|
||||||
|
const wrapper = makeWrapper({
|
||||||
|
encounter: buildEncounter({
|
||||||
|
combatants: [
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c-1"),
|
||||||
|
name: "Hero",
|
||||||
|
playerCharacterId: pcId1,
|
||||||
|
}),
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c-2"),
|
||||||
|
name: "Allied Guard",
|
||||||
|
creatureId: goblinCreature.id,
|
||||||
|
side: "party",
|
||||||
|
}),
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c-3"),
|
||||||
|
name: "Thug",
|
||||||
|
cr: "1",
|
||||||
|
}),
|
||||||
|
],
|
||||||
|
}),
|
||||||
|
playerCharacters: [
|
||||||
|
{ id: pcId1, name: "Hero", ac: 15, maxHp: 30, level: 5 },
|
||||||
|
],
|
||||||
|
creatures: new Map([[goblinCreature.id, goblinCreature]]),
|
||||||
|
});
|
||||||
|
|
||||||
|
const { result } = renderHook(() => useDifficultyBreakdown(), {
|
||||||
|
wrapper,
|
||||||
|
});
|
||||||
|
|
||||||
|
const breakdown = result.current;
|
||||||
|
expect(breakdown).not.toBeNull();
|
||||||
|
// Allied Guard should be in party column
|
||||||
|
expect(breakdown?.partyCombatants).toHaveLength(2);
|
||||||
|
expect(breakdown?.partyCombatants[1].combatant.name).toBe("Allied Guard");
|
||||||
|
expect(breakdown?.partyCombatants[1].side).toBe("party");
|
||||||
|
// Thug in enemy column
|
||||||
|
expect(breakdown?.enemyCombatants).toHaveLength(1);
|
||||||
|
expect(breakdown?.enemyCombatants[0].combatant.name).toBe("Thug");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("exposes encounterMultiplier and adjustedXp for 5e edition", async () => {
|
||||||
|
const wrapper = makeWrapper({
|
||||||
|
encounter: buildEncounter({
|
||||||
|
combatants: [
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c-1"),
|
||||||
|
name: "Hero",
|
||||||
|
playerCharacterId: pcId1,
|
||||||
|
}),
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c-2"),
|
||||||
|
name: "Goblin",
|
||||||
|
creatureId: goblinCreature.id,
|
||||||
|
}),
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c-3"),
|
||||||
|
name: "Thug",
|
||||||
|
cr: "1",
|
||||||
|
}),
|
||||||
|
],
|
||||||
|
}),
|
||||||
|
playerCharacters: [
|
||||||
|
{ id: pcId1, name: "Hero", ac: 15, maxHp: 30, level: 1 },
|
||||||
|
],
|
||||||
|
creatures: new Map([[goblinCreature.id, goblinCreature]]),
|
||||||
|
});
|
||||||
|
|
||||||
|
const { result: editionResult } = renderHook(() => useRulesEdition(), {
|
||||||
|
wrapper,
|
||||||
|
});
|
||||||
|
editionResult.current.setEdition("5e");
|
||||||
|
|
||||||
|
try {
|
||||||
|
const { result } = renderHook(() => useDifficultyBreakdown(), {
|
||||||
|
wrapper,
|
||||||
|
});
|
||||||
|
|
||||||
|
await waitFor(() => {
|
||||||
|
const breakdown = result.current;
|
||||||
|
expect(breakdown).not.toBeNull();
|
||||||
|
// 2 enemy monsters, 1 PC (<3) → base x1.5, shift up → x2
|
||||||
|
expect(breakdown?.encounterMultiplier).toBe(2);
|
||||||
|
// CR 1/4 (50) + CR 1 (200) = 250, x2 = 500
|
||||||
|
expect(breakdown?.totalMonsterXp).toBe(250);
|
||||||
|
expect(breakdown?.adjustedXp).toBe(500);
|
||||||
|
expect(breakdown?.thresholds).toHaveLength(4);
|
||||||
|
});
|
||||||
|
} finally {
|
||||||
|
editionResult.current.setEdition("5.5e");
|
||||||
|
}
|
||||||
|
});
|
||||||
});
|
});
|
||||||
|
|||||||
@@ -1,220 +0,0 @@
|
|||||||
// @vitest-environment jsdom
|
|
||||||
import type {
|
|
||||||
Combatant,
|
|
||||||
CreatureId,
|
|
||||||
Encounter,
|
|
||||||
PlayerCharacter,
|
|
||||||
} from "@initiative/domain";
|
|
||||||
import { combatantId, creatureId, playerCharacterId } from "@initiative/domain";
|
|
||||||
import { renderHook } from "@testing-library/react";
|
|
||||||
import { beforeEach, describe, expect, it, vi } from "vitest";
|
|
||||||
|
|
||||||
vi.mock("../../contexts/encounter-context.js", () => ({
|
|
||||||
useEncounterContext: vi.fn(),
|
|
||||||
}));
|
|
||||||
|
|
||||||
vi.mock("../../contexts/player-characters-context.js", () => ({
|
|
||||||
usePlayerCharactersContext: vi.fn(),
|
|
||||||
}));
|
|
||||||
|
|
||||||
vi.mock("../../contexts/bestiary-context.js", () => ({
|
|
||||||
useBestiaryContext: vi.fn(),
|
|
||||||
}));
|
|
||||||
|
|
||||||
import { useBestiaryContext } from "../../contexts/bestiary-context.js";
|
|
||||||
import { useEncounterContext } from "../../contexts/encounter-context.js";
|
|
||||||
import { usePlayerCharactersContext } from "../../contexts/player-characters-context.js";
|
|
||||||
import { useDifficulty } from "../use-difficulty.js";
|
|
||||||
|
|
||||||
const mockEncounterContext = vi.mocked(useEncounterContext);
|
|
||||||
const mockPlayerCharactersContext = vi.mocked(usePlayerCharactersContext);
|
|
||||||
const mockBestiaryContext = vi.mocked(useBestiaryContext);
|
|
||||||
|
|
||||||
const pcId1 = playerCharacterId("pc-1");
|
|
||||||
const pcId2 = playerCharacterId("pc-2");
|
|
||||||
const crId1 = creatureId("creature-1");
|
|
||||||
const _crId2 = creatureId("creature-2");
|
|
||||||
|
|
||||||
function setup(options: {
|
|
||||||
combatants: Combatant[];
|
|
||||||
characters: PlayerCharacter[];
|
|
||||||
creatures: Map<CreatureId, { cr: string }>;
|
|
||||||
}) {
|
|
||||||
const encounter = {
|
|
||||||
combatants: options.combatants,
|
|
||||||
activeIndex: 0,
|
|
||||||
roundNumber: 1,
|
|
||||||
} as Encounter;
|
|
||||||
|
|
||||||
mockEncounterContext.mockReturnValue({
|
|
||||||
encounter,
|
|
||||||
} as ReturnType<typeof useEncounterContext>);
|
|
||||||
|
|
||||||
mockPlayerCharactersContext.mockReturnValue({
|
|
||||||
characters: options.characters,
|
|
||||||
} as ReturnType<typeof usePlayerCharactersContext>);
|
|
||||||
|
|
||||||
mockBestiaryContext.mockReturnValue({
|
|
||||||
getCreature: (id: CreatureId) => options.creatures.get(id),
|
|
||||||
} as ReturnType<typeof useBestiaryContext>);
|
|
||||||
}
|
|
||||||
|
|
||||||
beforeEach(() => {
|
|
||||||
vi.clearAllMocks();
|
|
||||||
});
|
|
||||||
|
|
||||||
describe("useDifficulty", () => {
|
|
||||||
it("returns difficulty result for leveled PCs and bestiary monsters", () => {
|
|
||||||
setup({
|
|
||||||
combatants: [
|
|
||||||
{ id: combatantId("c1"), name: "Hero", playerCharacterId: pcId1 },
|
|
||||||
{ id: combatantId("c2"), name: "Goblin", creatureId: crId1 },
|
|
||||||
],
|
|
||||||
characters: [{ id: pcId1, name: "Hero", ac: 15, maxHp: 30, level: 1 }],
|
|
||||||
creatures: new Map([[crId1, { cr: "1/4" }]]),
|
|
||||||
});
|
|
||||||
|
|
||||||
const { result } = renderHook(() => useDifficulty());
|
|
||||||
|
|
||||||
expect(result.current).not.toBeNull();
|
|
||||||
expect(result.current?.tier).toBe("low");
|
|
||||||
expect(result.current?.totalMonsterXp).toBe(50);
|
|
||||||
});
|
|
||||||
|
|
||||||
describe("returns null when data is insufficient (ED-2)", () => {
|
|
||||||
it("returns null when encounter has no combatants", () => {
|
|
||||||
setup({ combatants: [], characters: [], creatures: new Map() });
|
|
||||||
|
|
||||||
const { result } = renderHook(() => useDifficulty());
|
|
||||||
expect(result.current).toBeNull();
|
|
||||||
});
|
|
||||||
|
|
||||||
it("returns null when only custom combatants (no creatureId)", () => {
|
|
||||||
setup({
|
|
||||||
combatants: [
|
|
||||||
{
|
|
||||||
id: combatantId("c1"),
|
|
||||||
name: "Custom",
|
|
||||||
playerCharacterId: pcId1,
|
|
||||||
},
|
|
||||||
],
|
|
||||||
characters: [{ id: pcId1, name: "Hero", ac: 15, maxHp: 30, level: 5 }],
|
|
||||||
creatures: new Map(),
|
|
||||||
});
|
|
||||||
|
|
||||||
const { result } = renderHook(() => useDifficulty());
|
|
||||||
expect(result.current).toBeNull();
|
|
||||||
});
|
|
||||||
|
|
||||||
it("returns null when bestiary monsters present but no PC combatants", () => {
|
|
||||||
setup({
|
|
||||||
combatants: [
|
|
||||||
{ id: combatantId("c1"), name: "Goblin", creatureId: crId1 },
|
|
||||||
],
|
|
||||||
characters: [],
|
|
||||||
creatures: new Map([[crId1, { cr: "1" }]]),
|
|
||||||
});
|
|
||||||
|
|
||||||
const { result } = renderHook(() => useDifficulty());
|
|
||||||
expect(result.current).toBeNull();
|
|
||||||
});
|
|
||||||
|
|
||||||
it("returns null when PC combatants have no level", () => {
|
|
||||||
setup({
|
|
||||||
combatants: [
|
|
||||||
{
|
|
||||||
id: combatantId("c1"),
|
|
||||||
name: "Hero",
|
|
||||||
playerCharacterId: pcId1,
|
|
||||||
},
|
|
||||||
{ id: combatantId("c2"), name: "Goblin", creatureId: crId1 },
|
|
||||||
],
|
|
||||||
characters: [{ id: pcId1, name: "Hero", ac: 15, maxHp: 30 }],
|
|
||||||
creatures: new Map([[crId1, { cr: "1" }]]),
|
|
||||||
});
|
|
||||||
|
|
||||||
const { result } = renderHook(() => useDifficulty());
|
|
||||||
expect(result.current).toBeNull();
|
|
||||||
});
|
|
||||||
|
|
||||||
it("returns null when PC combatant references unknown player character", () => {
|
|
||||||
setup({
|
|
||||||
combatants: [
|
|
||||||
{
|
|
||||||
id: combatantId("c1"),
|
|
||||||
name: "Hero",
|
|
||||||
playerCharacterId: pcId2,
|
|
||||||
},
|
|
||||||
{ id: combatantId("c2"), name: "Goblin", creatureId: crId1 },
|
|
||||||
],
|
|
||||||
characters: [{ id: pcId1, name: "Other", ac: 15, maxHp: 30, level: 5 }],
|
|
||||||
creatures: new Map([[crId1, { cr: "1" }]]),
|
|
||||||
});
|
|
||||||
|
|
||||||
const { result } = renderHook(() => useDifficulty());
|
|
||||||
expect(result.current).toBeNull();
|
|
||||||
});
|
|
||||||
});
|
|
||||||
|
|
||||||
it("handles mixed combatants: only leveled PCs and bestiary monsters contribute", () => {
|
|
||||||
// Party: one leveled PC, one without level (excluded)
|
|
||||||
// Monsters: one bestiary creature, one custom (excluded)
|
|
||||||
setup({
|
|
||||||
combatants: [
|
|
||||||
{
|
|
||||||
id: combatantId("c1"),
|
|
||||||
name: "Leveled",
|
|
||||||
playerCharacterId: pcId1,
|
|
||||||
},
|
|
||||||
{
|
|
||||||
id: combatantId("c2"),
|
|
||||||
name: "No Level",
|
|
||||||
playerCharacterId: pcId2,
|
|
||||||
},
|
|
||||||
{ id: combatantId("c3"), name: "Goblin", creatureId: crId1 },
|
|
||||||
{ id: combatantId("c4"), name: "Custom Monster" },
|
|
||||||
],
|
|
||||||
characters: [
|
|
||||||
{ id: pcId1, name: "Leveled", ac: 15, maxHp: 30, level: 1 },
|
|
||||||
{ id: pcId2, name: "No Level", ac: 12, maxHp: 20 },
|
|
||||||
],
|
|
||||||
creatures: new Map([[crId1, { cr: "1" }]]),
|
|
||||||
});
|
|
||||||
|
|
||||||
const { result } = renderHook(() => useDifficulty());
|
|
||||||
|
|
||||||
expect(result.current).not.toBeNull();
|
|
||||||
// 1 level-1 PC: budget low=50, mod=75, high=100
|
|
||||||
// 1 CR 1 monster: 200 XP → high (200 >= 100)
|
|
||||||
expect(result.current?.tier).toBe("high");
|
|
||||||
expect(result.current?.totalMonsterXp).toBe(200);
|
|
||||||
expect(result.current?.partyBudget.low).toBe(50);
|
|
||||||
});
|
|
||||||
|
|
||||||
it("includes duplicate PC combatants in budget", () => {
|
|
||||||
// Same PC added twice → counts twice
|
|
||||||
setup({
|
|
||||||
combatants: [
|
|
||||||
{
|
|
||||||
id: combatantId("c1"),
|
|
||||||
name: "Hero 1",
|
|
||||||
playerCharacterId: pcId1,
|
|
||||||
},
|
|
||||||
{
|
|
||||||
id: combatantId("c2"),
|
|
||||||
name: "Hero 2",
|
|
||||||
playerCharacterId: pcId1,
|
|
||||||
},
|
|
||||||
{ id: combatantId("c3"), name: "Goblin", creatureId: crId1 },
|
|
||||||
],
|
|
||||||
characters: [{ id: pcId1, name: "Hero", ac: 15, maxHp: 30, level: 1 }],
|
|
||||||
creatures: new Map([[crId1, { cr: "1/4" }]]),
|
|
||||||
});
|
|
||||||
|
|
||||||
const { result } = renderHook(() => useDifficulty());
|
|
||||||
|
|
||||||
expect(result.current).not.toBeNull();
|
|
||||||
// 2x level 1: budget low=100
|
|
||||||
expect(result.current?.partyBudget.low).toBe(100);
|
|
||||||
});
|
|
||||||
});
|
|
||||||
427
apps/web/src/hooks/__tests__/use-difficulty.test.tsx
Normal file
427
apps/web/src/hooks/__tests__/use-difficulty.test.tsx
Normal file
@@ -0,0 +1,427 @@
|
|||||||
|
// @vitest-environment jsdom
|
||||||
|
import type { Creature, CreatureId, PlayerCharacter } from "@initiative/domain";
|
||||||
|
import { combatantId, creatureId, playerCharacterId } from "@initiative/domain";
|
||||||
|
import { renderHook, waitFor } from "@testing-library/react";
|
||||||
|
import type { ReactNode } from "react";
|
||||||
|
import { beforeAll, describe, expect, it, vi } from "vitest";
|
||||||
|
import { createTestAdapters } from "../../__tests__/adapters/in-memory-adapters.js";
|
||||||
|
import {
|
||||||
|
buildCombatant,
|
||||||
|
buildCreature,
|
||||||
|
buildEncounter,
|
||||||
|
} from "../../__tests__/factories/index.js";
|
||||||
|
import { AllProviders } from "../../__tests__/test-providers.js";
|
||||||
|
import { useDifficulty } from "../use-difficulty.js";
|
||||||
|
import { useRulesEdition } from "../use-rules-edition.js";
|
||||||
|
|
||||||
|
beforeAll(() => {
|
||||||
|
Object.defineProperty(globalThis, "matchMedia", {
|
||||||
|
writable: true,
|
||||||
|
value: vi.fn().mockImplementation((query: string) => ({
|
||||||
|
matches: false,
|
||||||
|
media: query,
|
||||||
|
onchange: null,
|
||||||
|
addListener: vi.fn(),
|
||||||
|
removeListener: vi.fn(),
|
||||||
|
addEventListener: vi.fn(),
|
||||||
|
removeEventListener: vi.fn(),
|
||||||
|
dispatchEvent: vi.fn(),
|
||||||
|
})),
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
const pcId1 = playerCharacterId("pc-1");
|
||||||
|
const pcId2 = playerCharacterId("pc-2");
|
||||||
|
const crId1 = creatureId("srd:goblin");
|
||||||
|
|
||||||
|
const goblinCreature = buildCreature({
|
||||||
|
id: crId1,
|
||||||
|
name: "Goblin",
|
||||||
|
cr: "1/4",
|
||||||
|
});
|
||||||
|
|
||||||
|
function makeWrapper(options: {
|
||||||
|
encounter: ReturnType<typeof buildEncounter>;
|
||||||
|
playerCharacters?: PlayerCharacter[];
|
||||||
|
creatures?: Map<CreatureId, Creature>;
|
||||||
|
}) {
|
||||||
|
const adapters = createTestAdapters({
|
||||||
|
encounter: options.encounter,
|
||||||
|
playerCharacters: options.playerCharacters ?? [],
|
||||||
|
creatures: options.creatures,
|
||||||
|
});
|
||||||
|
return ({ children }: { children: ReactNode }) => (
|
||||||
|
<AllProviders adapters={adapters}>{children}</AllProviders>
|
||||||
|
);
|
||||||
|
}
|
||||||
|
|
||||||
|
describe("useDifficulty", () => {
|
||||||
|
it("returns difficulty result for leveled PCs and bestiary monsters", async () => {
|
||||||
|
const wrapper = makeWrapper({
|
||||||
|
encounter: buildEncounter({
|
||||||
|
combatants: [
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c1"),
|
||||||
|
name: "Hero",
|
||||||
|
playerCharacterId: pcId1,
|
||||||
|
}),
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c2"),
|
||||||
|
name: "Goblin",
|
||||||
|
creatureId: crId1,
|
||||||
|
}),
|
||||||
|
],
|
||||||
|
}),
|
||||||
|
playerCharacters: [
|
||||||
|
{ id: pcId1, name: "Hero", ac: 15, maxHp: 30, level: 1 },
|
||||||
|
],
|
||||||
|
creatures: new Map([[crId1, goblinCreature]]),
|
||||||
|
});
|
||||||
|
|
||||||
|
const { result } = renderHook(() => useDifficulty(), { wrapper });
|
||||||
|
|
||||||
|
await waitFor(() => {
|
||||||
|
expect(result.current).not.toBeNull();
|
||||||
|
expect(result.current?.tier).toBe(1);
|
||||||
|
expect(result.current?.totalMonsterXp).toBe(50);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe("returns null when data is insufficient (ED-2)", () => {
|
||||||
|
it("returns null when encounter has no combatants", () => {
|
||||||
|
const wrapper = makeWrapper({
|
||||||
|
encounter: buildEncounter({ combatants: [] }),
|
||||||
|
});
|
||||||
|
|
||||||
|
const { result } = renderHook(() => useDifficulty(), { wrapper });
|
||||||
|
expect(result.current).toBeNull();
|
||||||
|
});
|
||||||
|
|
||||||
|
it("returns null when only custom combatants (no creatureId)", () => {
|
||||||
|
const wrapper = makeWrapper({
|
||||||
|
encounter: buildEncounter({
|
||||||
|
combatants: [
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c1"),
|
||||||
|
name: "Custom",
|
||||||
|
playerCharacterId: pcId1,
|
||||||
|
}),
|
||||||
|
],
|
||||||
|
}),
|
||||||
|
playerCharacters: [
|
||||||
|
{ id: pcId1, name: "Hero", ac: 15, maxHp: 30, level: 5 },
|
||||||
|
],
|
||||||
|
});
|
||||||
|
|
||||||
|
const { result } = renderHook(() => useDifficulty(), { wrapper });
|
||||||
|
expect(result.current).toBeNull();
|
||||||
|
});
|
||||||
|
|
||||||
|
it("returns null when bestiary monsters present but no PC combatants", () => {
|
||||||
|
const wrapper = makeWrapper({
|
||||||
|
encounter: buildEncounter({
|
||||||
|
combatants: [
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c1"),
|
||||||
|
name: "Goblin",
|
||||||
|
creatureId: crId1,
|
||||||
|
}),
|
||||||
|
],
|
||||||
|
}),
|
||||||
|
creatures: new Map([[crId1, goblinCreature]]),
|
||||||
|
});
|
||||||
|
|
||||||
|
const { result } = renderHook(() => useDifficulty(), { wrapper });
|
||||||
|
expect(result.current).toBeNull();
|
||||||
|
});
|
||||||
|
|
||||||
|
it("returns null when PC combatants have no level", () => {
|
||||||
|
const wrapper = makeWrapper({
|
||||||
|
encounter: buildEncounter({
|
||||||
|
combatants: [
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c1"),
|
||||||
|
name: "Hero",
|
||||||
|
playerCharacterId: pcId1,
|
||||||
|
}),
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c2"),
|
||||||
|
name: "Goblin",
|
||||||
|
creatureId: crId1,
|
||||||
|
}),
|
||||||
|
],
|
||||||
|
}),
|
||||||
|
playerCharacters: [{ id: pcId1, name: "Hero", ac: 15, maxHp: 30 }],
|
||||||
|
creatures: new Map([[crId1, goblinCreature]]),
|
||||||
|
});
|
||||||
|
|
||||||
|
const { result } = renderHook(() => useDifficulty(), { wrapper });
|
||||||
|
expect(result.current).toBeNull();
|
||||||
|
});
|
||||||
|
|
||||||
|
it("returns null when PC combatant references unknown player character", () => {
|
||||||
|
const wrapper = makeWrapper({
|
||||||
|
encounter: buildEncounter({
|
||||||
|
combatants: [
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c1"),
|
||||||
|
name: "Hero",
|
||||||
|
playerCharacterId: pcId2,
|
||||||
|
}),
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c2"),
|
||||||
|
name: "Goblin",
|
||||||
|
creatureId: crId1,
|
||||||
|
}),
|
||||||
|
],
|
||||||
|
}),
|
||||||
|
playerCharacters: [
|
||||||
|
{ id: pcId1, name: "Other", ac: 15, maxHp: 30, level: 5 },
|
||||||
|
],
|
||||||
|
creatures: new Map([[crId1, goblinCreature]]),
|
||||||
|
});
|
||||||
|
|
||||||
|
const { result } = renderHook(() => useDifficulty(), { wrapper });
|
||||||
|
expect(result.current).toBeNull();
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
it("handles mixed combatants: only leveled PCs and CR-bearing monsters contribute", async () => {
|
||||||
|
const wrapper = makeWrapper({
|
||||||
|
encounter: buildEncounter({
|
||||||
|
combatants: [
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c1"),
|
||||||
|
name: "Leveled",
|
||||||
|
playerCharacterId: pcId1,
|
||||||
|
}),
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c2"),
|
||||||
|
name: "No Level",
|
||||||
|
playerCharacterId: pcId2,
|
||||||
|
}),
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c3"),
|
||||||
|
name: "Goblin",
|
||||||
|
creatureId: crId1,
|
||||||
|
}),
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c4"),
|
||||||
|
name: "Custom Monster",
|
||||||
|
}),
|
||||||
|
],
|
||||||
|
}),
|
||||||
|
playerCharacters: [
|
||||||
|
{ id: pcId1, name: "Leveled", ac: 15, maxHp: 30, level: 1 },
|
||||||
|
{ id: pcId2, name: "No Level", ac: 12, maxHp: 20 },
|
||||||
|
],
|
||||||
|
creatures: new Map([[crId1, goblinCreature]]),
|
||||||
|
});
|
||||||
|
|
||||||
|
const { result } = renderHook(() => useDifficulty(), { wrapper });
|
||||||
|
|
||||||
|
await waitFor(() => {
|
||||||
|
expect(result.current).not.toBeNull();
|
||||||
|
// 1 level-1 PC: budget low=50, mod=75, high=100
|
||||||
|
// CR 1/4 = 50 XP -> low (50 >= 50)
|
||||||
|
expect(result.current?.tier).toBe(1);
|
||||||
|
expect(result.current?.totalMonsterXp).toBe(50);
|
||||||
|
expect(result.current?.thresholds[0].value).toBe(50);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
it("includes duplicate PC combatants in budget", async () => {
|
||||||
|
const wrapper = makeWrapper({
|
||||||
|
encounter: buildEncounter({
|
||||||
|
combatants: [
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c1"),
|
||||||
|
name: "Hero 1",
|
||||||
|
playerCharacterId: pcId1,
|
||||||
|
}),
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c2"),
|
||||||
|
name: "Hero 2",
|
||||||
|
playerCharacterId: pcId1,
|
||||||
|
}),
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c3"),
|
||||||
|
name: "Goblin",
|
||||||
|
creatureId: crId1,
|
||||||
|
}),
|
||||||
|
],
|
||||||
|
}),
|
||||||
|
playerCharacters: [
|
||||||
|
{ id: pcId1, name: "Hero", ac: 15, maxHp: 30, level: 1 },
|
||||||
|
],
|
||||||
|
creatures: new Map([[crId1, goblinCreature]]),
|
||||||
|
});
|
||||||
|
|
||||||
|
const { result } = renderHook(() => useDifficulty(), { wrapper });
|
||||||
|
|
||||||
|
await waitFor(() => {
|
||||||
|
expect(result.current).not.toBeNull();
|
||||||
|
// 2x level 1: budget low=100
|
||||||
|
expect(result.current?.thresholds[0].value).toBe(100);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
it("combatant toggled to party side subtracts XP", async () => {
|
||||||
|
const bugbear = buildCreature({
|
||||||
|
id: creatureId("srd:bugbear"),
|
||||||
|
name: "Bugbear",
|
||||||
|
cr: "1",
|
||||||
|
});
|
||||||
|
const wrapper = makeWrapper({
|
||||||
|
encounter: buildEncounter({
|
||||||
|
combatants: [
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c1"),
|
||||||
|
name: "Hero",
|
||||||
|
playerCharacterId: pcId1,
|
||||||
|
}),
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c2"),
|
||||||
|
name: "Allied Guard",
|
||||||
|
creatureId: bugbear.id,
|
||||||
|
side: "party",
|
||||||
|
}),
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c3"),
|
||||||
|
name: "Thug",
|
||||||
|
cr: "1",
|
||||||
|
}),
|
||||||
|
],
|
||||||
|
}),
|
||||||
|
playerCharacters: [
|
||||||
|
{ id: pcId1, name: "Hero", ac: 15, maxHp: 30, level: 1 },
|
||||||
|
],
|
||||||
|
creatures: new Map([[bugbear.id, bugbear]]),
|
||||||
|
});
|
||||||
|
|
||||||
|
const { result } = renderHook(() => useDifficulty(), { wrapper });
|
||||||
|
|
||||||
|
await waitFor(() => {
|
||||||
|
expect(result.current).not.toBeNull();
|
||||||
|
// Thug CR 1 = 200 XP, Allied Guard CR 1 = 200 XP subtracted, net = 0
|
||||||
|
expect(result.current?.totalMonsterXp).toBe(0);
|
||||||
|
expect(result.current?.tier).toBe(0);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
it("default side resolution: PC -> party, non-PC -> enemy", async () => {
|
||||||
|
const wrapper = makeWrapper({
|
||||||
|
encounter: buildEncounter({
|
||||||
|
combatants: [
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c1"),
|
||||||
|
name: "Hero",
|
||||||
|
playerCharacterId: pcId1,
|
||||||
|
}),
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c2"),
|
||||||
|
name: "Goblin",
|
||||||
|
creatureId: crId1,
|
||||||
|
}),
|
||||||
|
],
|
||||||
|
}),
|
||||||
|
playerCharacters: [
|
||||||
|
{ id: pcId1, name: "Hero", ac: 15, maxHp: 30, level: 3 },
|
||||||
|
],
|
||||||
|
creatures: new Map([[crId1, goblinCreature]]),
|
||||||
|
});
|
||||||
|
|
||||||
|
const { result } = renderHook(() => useDifficulty(), { wrapper });
|
||||||
|
|
||||||
|
await waitFor(() => {
|
||||||
|
expect(result.current).not.toBeNull();
|
||||||
|
// Level 3 budget: low=150, mod=225, high=400
|
||||||
|
// CR 1/4 = 50 XP -> trivial
|
||||||
|
expect(result.current?.thresholds[0].value).toBe(150);
|
||||||
|
expect(result.current?.totalMonsterXp).toBe(50);
|
||||||
|
expect(result.current?.tier).toBe(0);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
it("returns 2014 difficulty when edition is 5e", async () => {
|
||||||
|
const wrapper = makeWrapper({
|
||||||
|
encounter: buildEncounter({
|
||||||
|
combatants: [
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c1"),
|
||||||
|
name: "Hero",
|
||||||
|
playerCharacterId: pcId1,
|
||||||
|
}),
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c2"),
|
||||||
|
name: "Goblin",
|
||||||
|
creatureId: crId1,
|
||||||
|
}),
|
||||||
|
],
|
||||||
|
}),
|
||||||
|
playerCharacters: [
|
||||||
|
{ id: pcId1, name: "Hero", ac: 15, maxHp: 30, level: 1 },
|
||||||
|
],
|
||||||
|
creatures: new Map([[crId1, goblinCreature]]),
|
||||||
|
});
|
||||||
|
|
||||||
|
// Set edition via the hook's external store
|
||||||
|
const { result: editionResult } = renderHook(() => useRulesEdition(), {
|
||||||
|
wrapper,
|
||||||
|
});
|
||||||
|
editionResult.current.setEdition("5e");
|
||||||
|
|
||||||
|
try {
|
||||||
|
const { result } = renderHook(() => useDifficulty(), { wrapper });
|
||||||
|
|
||||||
|
await waitFor(() => {
|
||||||
|
expect(result.current).not.toBeNull();
|
||||||
|
// 2014: 4 thresholds with Easy/Medium/Hard/Deadly labels
|
||||||
|
expect(result.current?.thresholds).toHaveLength(4);
|
||||||
|
expect(result.current?.thresholds[0].label).toBe("Easy");
|
||||||
|
// CR 1/4 = 50 XP, 1 PC (<3) shifts x1 → x1.5, adjusted = 75
|
||||||
|
expect(result.current?.encounterMultiplier).toBe(1.5);
|
||||||
|
expect(result.current?.adjustedXp).toBe(75);
|
||||||
|
});
|
||||||
|
} finally {
|
||||||
|
editionResult.current.setEdition("5.5e");
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
it("custom combatant with CR on party side subtracts XP", async () => {
|
||||||
|
const wrapper = makeWrapper({
|
||||||
|
encounter: buildEncounter({
|
||||||
|
combatants: [
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c1"),
|
||||||
|
name: "Hero",
|
||||||
|
playerCharacterId: pcId1,
|
||||||
|
}),
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c2"),
|
||||||
|
name: "Ally",
|
||||||
|
cr: "2",
|
||||||
|
side: "party",
|
||||||
|
}),
|
||||||
|
buildCombatant({
|
||||||
|
id: combatantId("c3"),
|
||||||
|
name: "Goblin",
|
||||||
|
creatureId: crId1,
|
||||||
|
}),
|
||||||
|
],
|
||||||
|
}),
|
||||||
|
playerCharacters: [
|
||||||
|
{ id: pcId1, name: "Hero", ac: 15, maxHp: 30, level: 5 },
|
||||||
|
],
|
||||||
|
creatures: new Map([[crId1, goblinCreature]]),
|
||||||
|
});
|
||||||
|
|
||||||
|
const { result } = renderHook(() => useDifficulty(), { wrapper });
|
||||||
|
|
||||||
|
await waitFor(() => {
|
||||||
|
expect(result.current).not.toBeNull();
|
||||||
|
// CR 1/4 = 50 XP enemy, CR 2 = 450 XP ally subtracted, net = 0 (floored)
|
||||||
|
expect(result.current?.totalMonsterXp).toBe(0);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
});
|
||||||
@@ -1,11 +1,12 @@
|
|||||||
// @vitest-environment jsdom
|
// @vitest-environment jsdom
|
||||||
import type { BestiaryIndexEntry, PlayerCharacter } from "@initiative/domain";
|
import type { PlayerCharacter } from "@initiative/domain";
|
||||||
import { combatantId, creatureId, playerCharacterId } from "@initiative/domain";
|
import { combatantId, creatureId, playerCharacterId } from "@initiative/domain";
|
||||||
import { act, renderHook } from "@testing-library/react";
|
import { act, renderHook } from "@testing-library/react";
|
||||||
import type { ReactNode } from "react";
|
import type { ReactNode } from "react";
|
||||||
import { beforeAll, describe, expect, it, vi } from "vitest";
|
import { beforeAll, describe, expect, it, vi } from "vitest";
|
||||||
import { createTestAdapters } from "../../__tests__/adapters/in-memory-adapters.js";
|
import { createTestAdapters } from "../../__tests__/adapters/in-memory-adapters.js";
|
||||||
import { AllProviders } from "../../__tests__/test-providers.js";
|
import { AllProviders } from "../../__tests__/test-providers.js";
|
||||||
|
import type { SearchResult } from "../use-bestiary.js";
|
||||||
import { useEncounter } from "../use-encounter.js";
|
import { useEncounter } from "../use-encounter.js";
|
||||||
|
|
||||||
beforeAll(() => {
|
beforeAll(() => {
|
||||||
@@ -152,9 +153,11 @@ describe("useEncounter", () => {
|
|||||||
expect(result.current.canRollAllInitiative).toBe(false);
|
expect(result.current.canRollAllInitiative).toBe(false);
|
||||||
|
|
||||||
// Add from bestiary to get a creature combatant
|
// Add from bestiary to get a creature combatant
|
||||||
const entry: BestiaryIndexEntry = {
|
const entry: SearchResult = {
|
||||||
|
system: "dnd",
|
||||||
name: "Goblin",
|
name: "Goblin",
|
||||||
source: "MM",
|
source: "MM",
|
||||||
|
sourceDisplayName: "Monster Manual",
|
||||||
ac: 15,
|
ac: 15,
|
||||||
hp: 7,
|
hp: 7,
|
||||||
dex: 14,
|
dex: 14,
|
||||||
@@ -175,9 +178,11 @@ describe("useEncounter", () => {
|
|||||||
it("addFromBestiary adds combatant with HP, AC, creatureId", () => {
|
it("addFromBestiary adds combatant with HP, AC, creatureId", () => {
|
||||||
const { result } = renderHook(() => useEncounter(), { wrapper });
|
const { result } = renderHook(() => useEncounter(), { wrapper });
|
||||||
|
|
||||||
const entry: BestiaryIndexEntry = {
|
const entry: SearchResult = {
|
||||||
|
system: "dnd",
|
||||||
name: "Goblin",
|
name: "Goblin",
|
||||||
source: "MM",
|
source: "MM",
|
||||||
|
sourceDisplayName: "Monster Manual",
|
||||||
ac: 15,
|
ac: 15,
|
||||||
hp: 7,
|
hp: 7,
|
||||||
dex: 14,
|
dex: 14,
|
||||||
@@ -202,9 +207,11 @@ describe("useEncounter", () => {
|
|||||||
it("addFromBestiary auto-numbers duplicate names", () => {
|
it("addFromBestiary auto-numbers duplicate names", () => {
|
||||||
const { result } = renderHook(() => useEncounter(), { wrapper });
|
const { result } = renderHook(() => useEncounter(), { wrapper });
|
||||||
|
|
||||||
const entry: BestiaryIndexEntry = {
|
const entry: SearchResult = {
|
||||||
|
system: "dnd",
|
||||||
name: "Goblin",
|
name: "Goblin",
|
||||||
source: "MM",
|
source: "MM",
|
||||||
|
sourceDisplayName: "Monster Manual",
|
||||||
ac: 15,
|
ac: 15,
|
||||||
hp: 7,
|
hp: 7,
|
||||||
dex: 14,
|
dex: 14,
|
||||||
|
|||||||
@@ -1,9 +1,10 @@
|
|||||||
// @vitest-environment jsdom
|
// @vitest-environment jsdom
|
||||||
import { act, renderHook } from "@testing-library/react";
|
import { act, renderHook } from "@testing-library/react";
|
||||||
import { afterEach, describe, expect, it } from "vitest";
|
import { afterEach, describe, expect, it, vi } from "vitest";
|
||||||
import { useRulesEdition } from "../use-rules-edition.js";
|
import { useRulesEdition } from "../use-rules-edition.js";
|
||||||
|
|
||||||
const STORAGE_KEY = "initiative:rules-edition";
|
const STORAGE_KEY = "initiative:game-system";
|
||||||
|
const OLD_STORAGE_KEY = "initiative:rules-edition";
|
||||||
|
|
||||||
describe("useRulesEdition", () => {
|
describe("useRulesEdition", () => {
|
||||||
afterEach(() => {
|
afterEach(() => {
|
||||||
@@ -11,6 +12,7 @@ describe("useRulesEdition", () => {
|
|||||||
const { result } = renderHook(() => useRulesEdition());
|
const { result } = renderHook(() => useRulesEdition());
|
||||||
act(() => result.current.setEdition("5.5e"));
|
act(() => result.current.setEdition("5.5e"));
|
||||||
localStorage.removeItem(STORAGE_KEY);
|
localStorage.removeItem(STORAGE_KEY);
|
||||||
|
localStorage.removeItem(OLD_STORAGE_KEY);
|
||||||
});
|
});
|
||||||
|
|
||||||
it("defaults to 5.5e", () => {
|
it("defaults to 5.5e", () => {
|
||||||
@@ -42,4 +44,31 @@ describe("useRulesEdition", () => {
|
|||||||
|
|
||||||
expect(r2.current.edition).toBe("5e");
|
expect(r2.current.edition).toBe("5e");
|
||||||
});
|
});
|
||||||
|
|
||||||
|
it("accepts pf2e as a valid game system", () => {
|
||||||
|
const { result } = renderHook(() => useRulesEdition());
|
||||||
|
|
||||||
|
act(() => result.current.setEdition("pf2e"));
|
||||||
|
|
||||||
|
expect(result.current.edition).toBe("pf2e");
|
||||||
|
expect(localStorage.getItem(STORAGE_KEY)).toBe("pf2e");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("migrates from old storage key on fresh module load", async () => {
|
||||||
|
// Set up old key before re-importing the module
|
||||||
|
localStorage.setItem(OLD_STORAGE_KEY, "5e");
|
||||||
|
localStorage.removeItem(STORAGE_KEY);
|
||||||
|
|
||||||
|
// Force a fresh module so loadEdition() re-runs at init time
|
||||||
|
vi.resetModules();
|
||||||
|
const { useRulesEdition: freshHook } = await import(
|
||||||
|
"../use-rules-edition.js"
|
||||||
|
);
|
||||||
|
|
||||||
|
const { result } = renderHook(() => freshHook());
|
||||||
|
|
||||||
|
expect(result.current.edition).toBe("5e");
|
||||||
|
expect(localStorage.getItem(STORAGE_KEY)).toBe("5e");
|
||||||
|
expect(localStorage.getItem(OLD_STORAGE_KEY)).toBeNull();
|
||||||
|
});
|
||||||
});
|
});
|
||||||
|
|||||||
@@ -1,22 +1,34 @@
|
|||||||
import type {
|
import type {
|
||||||
|
AnyCreature,
|
||||||
BestiaryIndexEntry,
|
BestiaryIndexEntry,
|
||||||
Creature,
|
|
||||||
CreatureId,
|
CreatureId,
|
||||||
|
Pf2eBestiaryIndexEntry,
|
||||||
} from "@initiative/domain";
|
} from "@initiative/domain";
|
||||||
import { useCallback, useEffect, useState } from "react";
|
import { useCallback, useEffect, useState } from "react";
|
||||||
import {
|
import {
|
||||||
normalizeBestiary,
|
normalizeBestiary,
|
||||||
setSourceDisplayNames,
|
setSourceDisplayNames,
|
||||||
} from "../adapters/bestiary-adapter.js";
|
} from "../adapters/bestiary-adapter.js";
|
||||||
|
import {
|
||||||
|
normalizePf2eBestiary,
|
||||||
|
setPf2eSourceDisplayNames,
|
||||||
|
} from "../adapters/pf2e-bestiary-adapter.js";
|
||||||
import { useAdapters } from "../contexts/adapter-context.js";
|
import { useAdapters } from "../contexts/adapter-context.js";
|
||||||
|
import { useRulesEditionContext } from "../contexts/rules-edition-context.js";
|
||||||
|
|
||||||
export interface SearchResult extends BestiaryIndexEntry {
|
export type SearchResult =
|
||||||
|
| (BestiaryIndexEntry & {
|
||||||
|
readonly system: "dnd";
|
||||||
readonly sourceDisplayName: string;
|
readonly sourceDisplayName: string;
|
||||||
}
|
})
|
||||||
|
| (Pf2eBestiaryIndexEntry & {
|
||||||
|
readonly system: "pf2e";
|
||||||
|
readonly sourceDisplayName: string;
|
||||||
|
});
|
||||||
|
|
||||||
interface BestiaryHook {
|
interface BestiaryHook {
|
||||||
search: (query: string) => SearchResult[];
|
search: (query: string) => SearchResult[];
|
||||||
getCreature: (id: CreatureId) => Creature | undefined;
|
getCreature: (id: CreatureId) => AnyCreature | undefined;
|
||||||
isLoaded: boolean;
|
isLoaded: boolean;
|
||||||
isSourceCached: (sourceCode: string) => Promise<boolean>;
|
isSourceCached: (sourceCode: string) => Promise<boolean>;
|
||||||
fetchAndCacheSource: (sourceCode: string, url: string) => Promise<void>;
|
fetchAndCacheSource: (sourceCode: string, url: string) => Promise<void>;
|
||||||
@@ -28,28 +40,47 @@ interface BestiaryHook {
|
|||||||
}
|
}
|
||||||
|
|
||||||
export function useBestiary(): BestiaryHook {
|
export function useBestiary(): BestiaryHook {
|
||||||
const { bestiaryCache, bestiaryIndex } = useAdapters();
|
const { bestiaryCache, bestiaryIndex, pf2eBestiaryIndex } = useAdapters();
|
||||||
|
const { edition } = useRulesEditionContext();
|
||||||
const [isLoaded, setIsLoaded] = useState(false);
|
const [isLoaded, setIsLoaded] = useState(false);
|
||||||
const [creatureMap, setCreatureMap] = useState(
|
const [creatureMap, setCreatureMap] = useState(
|
||||||
() => new Map<CreatureId, Creature>(),
|
() => new Map<CreatureId, AnyCreature>(),
|
||||||
);
|
);
|
||||||
|
|
||||||
useEffect(() => {
|
useEffect(() => {
|
||||||
const index = bestiaryIndex.loadIndex();
|
const index = bestiaryIndex.loadIndex();
|
||||||
setSourceDisplayNames(index.sources as Record<string, string>);
|
setSourceDisplayNames(index.sources as Record<string, string>);
|
||||||
if (index.creatures.length > 0) {
|
|
||||||
|
const pf2eIndex = pf2eBestiaryIndex.loadIndex();
|
||||||
|
setPf2eSourceDisplayNames(pf2eIndex.sources as Record<string, string>);
|
||||||
|
|
||||||
|
if (index.creatures.length > 0 || pf2eIndex.creatures.length > 0) {
|
||||||
setIsLoaded(true);
|
setIsLoaded(true);
|
||||||
}
|
}
|
||||||
|
|
||||||
void bestiaryCache.loadAllCachedCreatures().then((map) => {
|
void bestiaryCache.loadAllCachedCreatures().then((map) => {
|
||||||
setCreatureMap(map);
|
setCreatureMap(map);
|
||||||
});
|
});
|
||||||
}, [bestiaryCache, bestiaryIndex]);
|
}, [bestiaryCache, bestiaryIndex, pf2eBestiaryIndex]);
|
||||||
|
|
||||||
const search = useCallback(
|
const search = useCallback(
|
||||||
(query: string): SearchResult[] => {
|
(query: string): SearchResult[] => {
|
||||||
if (query.length < 2) return [];
|
if (query.length < 2) return [];
|
||||||
const lower = query.toLowerCase();
|
const lower = query.toLowerCase();
|
||||||
|
|
||||||
|
if (edition === "pf2e") {
|
||||||
|
const index = pf2eBestiaryIndex.loadIndex();
|
||||||
|
return index.creatures
|
||||||
|
.filter((c) => c.name.toLowerCase().includes(lower))
|
||||||
|
.sort((a, b) => a.name.localeCompare(b.name))
|
||||||
|
.slice(0, 10)
|
||||||
|
.map((c) => ({
|
||||||
|
...c,
|
||||||
|
system: "pf2e" as const,
|
||||||
|
sourceDisplayName: pf2eBestiaryIndex.getSourceDisplayName(c.source),
|
||||||
|
}));
|
||||||
|
}
|
||||||
|
|
||||||
const index = bestiaryIndex.loadIndex();
|
const index = bestiaryIndex.loadIndex();
|
||||||
return index.creatures
|
return index.creatures
|
||||||
.filter((c) => c.name.toLowerCase().includes(lower))
|
.filter((c) => c.name.toLowerCase().includes(lower))
|
||||||
@@ -57,24 +88,27 @@ export function useBestiary(): BestiaryHook {
|
|||||||
.slice(0, 10)
|
.slice(0, 10)
|
||||||
.map((c) => ({
|
.map((c) => ({
|
||||||
...c,
|
...c,
|
||||||
|
system: "dnd" as const,
|
||||||
sourceDisplayName: bestiaryIndex.getSourceDisplayName(c.source),
|
sourceDisplayName: bestiaryIndex.getSourceDisplayName(c.source),
|
||||||
}));
|
}));
|
||||||
},
|
},
|
||||||
[bestiaryIndex],
|
[bestiaryIndex, pf2eBestiaryIndex, edition],
|
||||||
);
|
);
|
||||||
|
|
||||||
const getCreature = useCallback(
|
const getCreature = useCallback(
|
||||||
(id: CreatureId): Creature | undefined => {
|
(id: CreatureId): AnyCreature | undefined => {
|
||||||
return creatureMap.get(id);
|
return creatureMap.get(id);
|
||||||
},
|
},
|
||||||
[creatureMap],
|
[creatureMap],
|
||||||
);
|
);
|
||||||
|
|
||||||
|
const system = edition === "pf2e" ? "pf2e" : "dnd";
|
||||||
|
|
||||||
const isSourceCachedFn = useCallback(
|
const isSourceCachedFn = useCallback(
|
||||||
(sourceCode: string): Promise<boolean> => {
|
(sourceCode: string): Promise<boolean> => {
|
||||||
return bestiaryCache.isSourceCached(sourceCode);
|
return bestiaryCache.isSourceCached(system, sourceCode);
|
||||||
},
|
},
|
||||||
[bestiaryCache],
|
[bestiaryCache, system],
|
||||||
);
|
);
|
||||||
|
|
||||||
const fetchAndCacheSource = useCallback(
|
const fetchAndCacheSource = useCallback(
|
||||||
@@ -86,9 +120,20 @@ export function useBestiary(): BestiaryHook {
|
|||||||
);
|
);
|
||||||
}
|
}
|
||||||
const json = await response.json();
|
const json = await response.json();
|
||||||
const creatures = normalizeBestiary(json);
|
const creatures =
|
||||||
const displayName = bestiaryIndex.getSourceDisplayName(sourceCode);
|
edition === "pf2e"
|
||||||
await bestiaryCache.cacheSource(sourceCode, displayName, creatures);
|
? normalizePf2eBestiary(json)
|
||||||
|
: normalizeBestiary(json);
|
||||||
|
const displayName =
|
||||||
|
edition === "pf2e"
|
||||||
|
? pf2eBestiaryIndex.getSourceDisplayName(sourceCode)
|
||||||
|
: bestiaryIndex.getSourceDisplayName(sourceCode);
|
||||||
|
await bestiaryCache.cacheSource(
|
||||||
|
system,
|
||||||
|
sourceCode,
|
||||||
|
displayName,
|
||||||
|
creatures,
|
||||||
|
);
|
||||||
setCreatureMap((prev) => {
|
setCreatureMap((prev) => {
|
||||||
const next = new Map(prev);
|
const next = new Map(prev);
|
||||||
for (const c of creatures) {
|
for (const c of creatures) {
|
||||||
@@ -97,15 +142,27 @@ export function useBestiary(): BestiaryHook {
|
|||||||
return next;
|
return next;
|
||||||
});
|
});
|
||||||
},
|
},
|
||||||
[bestiaryCache, bestiaryIndex],
|
[bestiaryCache, bestiaryIndex, pf2eBestiaryIndex, edition, system],
|
||||||
);
|
);
|
||||||
|
|
||||||
const uploadAndCacheSource = useCallback(
|
const uploadAndCacheSource = useCallback(
|
||||||
async (sourceCode: string, jsonData: unknown): Promise<void> => {
|
async (sourceCode: string, jsonData: unknown): Promise<void> => {
|
||||||
// biome-ignore lint/suspicious/noExplicitAny: raw JSON shape varies
|
const creatures =
|
||||||
const creatures = normalizeBestiary(jsonData as any);
|
edition === "pf2e"
|
||||||
const displayName = bestiaryIndex.getSourceDisplayName(sourceCode);
|
? normalizePf2eBestiary(jsonData as { creature: unknown[] })
|
||||||
await bestiaryCache.cacheSource(sourceCode, displayName, creatures);
|
: normalizeBestiary(
|
||||||
|
jsonData as Parameters<typeof normalizeBestiary>[0],
|
||||||
|
);
|
||||||
|
const displayName =
|
||||||
|
edition === "pf2e"
|
||||||
|
? pf2eBestiaryIndex.getSourceDisplayName(sourceCode)
|
||||||
|
: bestiaryIndex.getSourceDisplayName(sourceCode);
|
||||||
|
await bestiaryCache.cacheSource(
|
||||||
|
system,
|
||||||
|
sourceCode,
|
||||||
|
displayName,
|
||||||
|
creatures,
|
||||||
|
);
|
||||||
setCreatureMap((prev) => {
|
setCreatureMap((prev) => {
|
||||||
const next = new Map(prev);
|
const next = new Map(prev);
|
||||||
for (const c of creatures) {
|
for (const c of creatures) {
|
||||||
@@ -114,7 +171,7 @@ export function useBestiary(): BestiaryHook {
|
|||||||
return next;
|
return next;
|
||||||
});
|
});
|
||||||
},
|
},
|
||||||
[bestiaryCache, bestiaryIndex],
|
[bestiaryCache, bestiaryIndex, pf2eBestiaryIndex, edition, system],
|
||||||
);
|
);
|
||||||
|
|
||||||
const refreshCache = useCallback(async (): Promise<void> => {
|
const refreshCache = useCallback(async (): Promise<void> => {
|
||||||
|
|||||||
@@ -1,5 +1,6 @@
|
|||||||
import { useCallback, useRef, useState } from "react";
|
import { useCallback, useRef, useState } from "react";
|
||||||
import { useAdapters } from "../contexts/adapter-context.js";
|
import { useAdapters } from "../contexts/adapter-context.js";
|
||||||
|
import { useRulesEditionContext } from "../contexts/rules-edition-context.js";
|
||||||
|
|
||||||
const BATCH_SIZE = 6;
|
const BATCH_SIZE = 6;
|
||||||
|
|
||||||
@@ -29,7 +30,9 @@ interface BulkImportHook {
|
|||||||
}
|
}
|
||||||
|
|
||||||
export function useBulkImport(): BulkImportHook {
|
export function useBulkImport(): BulkImportHook {
|
||||||
const { bestiaryIndex } = useAdapters();
|
const { bestiaryIndex, pf2eBestiaryIndex } = useAdapters();
|
||||||
|
const { edition } = useRulesEditionContext();
|
||||||
|
const indexPort = edition === "pf2e" ? pf2eBestiaryIndex : bestiaryIndex;
|
||||||
const [state, setState] = useState<BulkImportState>(IDLE_STATE);
|
const [state, setState] = useState<BulkImportState>(IDLE_STATE);
|
||||||
const countersRef = useRef({ completed: 0, failed: 0 });
|
const countersRef = useRef({ completed: 0, failed: 0 });
|
||||||
|
|
||||||
@@ -40,7 +43,7 @@ export function useBulkImport(): BulkImportHook {
|
|||||||
isSourceCached: (sourceCode: string) => Promise<boolean>,
|
isSourceCached: (sourceCode: string) => Promise<boolean>,
|
||||||
refreshCache: () => Promise<void>,
|
refreshCache: () => Promise<void>,
|
||||||
) => {
|
) => {
|
||||||
const allCodes = bestiaryIndex.getAllSourceCodes();
|
const allCodes = indexPort.getAllSourceCodes();
|
||||||
const total = allCodes.length;
|
const total = allCodes.length;
|
||||||
|
|
||||||
countersRef.current = { completed: 0, failed: 0 };
|
countersRef.current = { completed: 0, failed: 0 };
|
||||||
@@ -81,7 +84,7 @@ export function useBulkImport(): BulkImportHook {
|
|||||||
chain.then(() =>
|
chain.then(() =>
|
||||||
Promise.allSettled(
|
Promise.allSettled(
|
||||||
batch.map(async ({ code }) => {
|
batch.map(async ({ code }) => {
|
||||||
const url = bestiaryIndex.getDefaultFetchUrl(code, baseUrl);
|
const url = indexPort.getDefaultFetchUrl(code, baseUrl);
|
||||||
try {
|
try {
|
||||||
await fetchAndCacheSource(code, url);
|
await fetchAndCacheSource(code, url);
|
||||||
countersRef.current.completed++;
|
countersRef.current.completed++;
|
||||||
@@ -115,7 +118,7 @@ export function useBulkImport(): BulkImportHook {
|
|||||||
});
|
});
|
||||||
})();
|
})();
|
||||||
},
|
},
|
||||||
[bestiaryIndex],
|
[indexPort],
|
||||||
);
|
);
|
||||||
|
|
||||||
const reset = useCallback(() => {
|
const reset = useCallback(() => {
|
||||||
|
|||||||
@@ -1,6 +1,7 @@
|
|||||||
import type {
|
import type {
|
||||||
Combatant,
|
Combatant,
|
||||||
CreatureId,
|
CreatureId,
|
||||||
|
DifficultyThreshold,
|
||||||
DifficultyTier,
|
DifficultyTier,
|
||||||
PlayerCharacter,
|
PlayerCharacter,
|
||||||
} from "@initiative/domain";
|
} from "@initiative/domain";
|
||||||
@@ -9,6 +10,8 @@ import { useMemo } from "react";
|
|||||||
import { useBestiaryContext } from "../contexts/bestiary-context.js";
|
import { useBestiaryContext } from "../contexts/bestiary-context.js";
|
||||||
import { useEncounterContext } from "../contexts/encounter-context.js";
|
import { useEncounterContext } from "../contexts/encounter-context.js";
|
||||||
import { usePlayerCharactersContext } from "../contexts/player-characters-context.js";
|
import { usePlayerCharactersContext } from "../contexts/player-characters-context.js";
|
||||||
|
import { useRulesEditionContext } from "../contexts/rules-edition-context.js";
|
||||||
|
import { resolveSide } from "./use-difficulty.js";
|
||||||
|
|
||||||
export interface BreakdownCombatant {
|
export interface BreakdownCombatant {
|
||||||
readonly combatant: Combatant;
|
readonly combatant: Combatant;
|
||||||
@@ -16,125 +19,153 @@ export interface BreakdownCombatant {
|
|||||||
readonly xp: number | null;
|
readonly xp: number | null;
|
||||||
readonly source: string | null;
|
readonly source: string | null;
|
||||||
readonly editable: boolean;
|
readonly editable: boolean;
|
||||||
|
readonly side: "party" | "enemy";
|
||||||
|
readonly level: number | undefined;
|
||||||
}
|
}
|
||||||
|
|
||||||
interface DifficultyBreakdown {
|
interface DifficultyBreakdown {
|
||||||
readonly tier: DifficultyTier;
|
readonly tier: DifficultyTier;
|
||||||
readonly totalMonsterXp: number;
|
readonly totalMonsterXp: number;
|
||||||
readonly partyBudget: {
|
readonly thresholds: readonly DifficultyThreshold[];
|
||||||
readonly low: number;
|
readonly encounterMultiplier: number | undefined;
|
||||||
readonly moderate: number;
|
readonly adjustedXp: number | undefined;
|
||||||
readonly high: number;
|
readonly partySizeAdjusted: boolean | undefined;
|
||||||
};
|
|
||||||
readonly pcCount: number;
|
readonly pcCount: number;
|
||||||
readonly combatants: readonly BreakdownCombatant[];
|
readonly partyCombatants: readonly BreakdownCombatant[];
|
||||||
|
readonly enemyCombatants: readonly BreakdownCombatant[];
|
||||||
}
|
}
|
||||||
|
|
||||||
export function useDifficultyBreakdown(): DifficultyBreakdown | null {
|
export function useDifficultyBreakdown(): DifficultyBreakdown | null {
|
||||||
const { encounter } = useEncounterContext();
|
const { encounter } = useEncounterContext();
|
||||||
const { characters } = usePlayerCharactersContext();
|
const { characters } = usePlayerCharactersContext();
|
||||||
const { getCreature } = useBestiaryContext();
|
const { getCreature } = useBestiaryContext();
|
||||||
|
const { edition } = useRulesEditionContext();
|
||||||
|
|
||||||
return useMemo(() => {
|
return useMemo(() => {
|
||||||
const partyLevels = derivePartyLevels(encounter.combatants, characters);
|
const { partyCombatants, enemyCombatants, descriptors, pcCount } =
|
||||||
const { entries, crs } = classifyCombatants(
|
classifyCombatants(encounter.combatants, characters, getCreature);
|
||||||
encounter.combatants,
|
|
||||||
getCreature,
|
const hasPartyLevel = descriptors.some(
|
||||||
|
(d) => d.side === "party" && d.level !== undefined,
|
||||||
);
|
);
|
||||||
|
const hasCr = descriptors.some((d) => d.cr !== undefined);
|
||||||
|
|
||||||
if (partyLevels.length === 0 || crs.length === 0) {
|
if (!hasPartyLevel || !hasCr) return null;
|
||||||
return null;
|
|
||||||
}
|
|
||||||
|
|
||||||
const result = calculateEncounterDifficulty(partyLevels, crs);
|
const result = calculateEncounterDifficulty(descriptors, edition);
|
||||||
|
|
||||||
return {
|
return {
|
||||||
...result,
|
...result,
|
||||||
pcCount: partyLevels.length,
|
pcCount,
|
||||||
combatants: entries,
|
partyCombatants,
|
||||||
|
enemyCombatants,
|
||||||
};
|
};
|
||||||
}, [encounter.combatants, characters, getCreature]);
|
}, [encounter.combatants, characters, getCreature, edition]);
|
||||||
}
|
}
|
||||||
|
|
||||||
function classifyBestiaryCombatant(
|
type CreatureInfo = {
|
||||||
|
cr?: string;
|
||||||
|
source: string;
|
||||||
|
sourceDisplayName: string;
|
||||||
|
};
|
||||||
|
|
||||||
|
function buildBreakdownEntry(
|
||||||
c: Combatant,
|
c: Combatant,
|
||||||
getCreature: (
|
side: "party" | "enemy",
|
||||||
id: CreatureId,
|
level: number | undefined,
|
||||||
) => { cr: string; source: string; sourceDisplayName: string } | undefined,
|
creature: CreatureInfo | undefined,
|
||||||
): { entry: BreakdownCombatant; cr: string | null } {
|
): BreakdownCombatant {
|
||||||
const creature = c.creatureId ? getCreature(c.creatureId) : undefined;
|
if (c.playerCharacterId) {
|
||||||
if (creature) {
|
|
||||||
return {
|
return {
|
||||||
entry: {
|
|
||||||
combatant: c,
|
|
||||||
cr: creature.cr,
|
|
||||||
xp: crToXp(creature.cr),
|
|
||||||
source: creature.sourceDisplayName ?? creature.source,
|
|
||||||
editable: false,
|
|
||||||
},
|
|
||||||
cr: creature.cr,
|
|
||||||
};
|
|
||||||
}
|
|
||||||
return {
|
|
||||||
entry: {
|
|
||||||
combatant: c,
|
combatant: c,
|
||||||
cr: null,
|
cr: null,
|
||||||
xp: null,
|
xp: null,
|
||||||
source: null,
|
source: null,
|
||||||
editable: false,
|
editable: false,
|
||||||
},
|
side,
|
||||||
cr: null,
|
level,
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
|
if (creature) {
|
||||||
function classifyCombatants(
|
const cr = creature.cr ?? null;
|
||||||
combatants: readonly Combatant[],
|
return {
|
||||||
getCreature: (
|
combatant: c,
|
||||||
id: CreatureId,
|
cr,
|
||||||
) => { cr: string; source: string; sourceDisplayName: string } | undefined,
|
xp: cr ? crToXp(cr) : null,
|
||||||
): { entries: BreakdownCombatant[]; crs: string[] } {
|
source: creature.sourceDisplayName ?? creature.source,
|
||||||
const entries: BreakdownCombatant[] = [];
|
editable: false,
|
||||||
const crs: string[] = [];
|
side,
|
||||||
|
level: undefined,
|
||||||
for (const c of combatants) {
|
};
|
||||||
if (c.playerCharacterId) continue;
|
}
|
||||||
|
if (c.cr) {
|
||||||
if (c.creatureId) {
|
return {
|
||||||
const { entry, cr } = classifyBestiaryCombatant(c, getCreature);
|
|
||||||
entries.push(entry);
|
|
||||||
if (cr) crs.push(cr);
|
|
||||||
} else if (c.cr) {
|
|
||||||
crs.push(c.cr);
|
|
||||||
entries.push({
|
|
||||||
combatant: c,
|
combatant: c,
|
||||||
cr: c.cr,
|
cr: c.cr,
|
||||||
xp: crToXp(c.cr),
|
xp: crToXp(c.cr),
|
||||||
source: null,
|
source: null,
|
||||||
editable: true,
|
editable: true,
|
||||||
});
|
side,
|
||||||
} else {
|
level: undefined,
|
||||||
entries.push({
|
};
|
||||||
|
}
|
||||||
|
return {
|
||||||
combatant: c,
|
combatant: c,
|
||||||
cr: null,
|
cr: null,
|
||||||
xp: null,
|
xp: null,
|
||||||
source: null,
|
source: null,
|
||||||
editable: true,
|
editable: !c.creatureId,
|
||||||
});
|
side,
|
||||||
}
|
level: undefined,
|
||||||
}
|
};
|
||||||
|
|
||||||
return { entries, crs };
|
|
||||||
}
|
}
|
||||||
|
|
||||||
function derivePartyLevels(
|
function resolveLevel(
|
||||||
|
c: Combatant,
|
||||||
|
characters: readonly PlayerCharacter[],
|
||||||
|
): number | undefined {
|
||||||
|
if (!c.playerCharacterId) return undefined;
|
||||||
|
return characters.find((p) => p.id === c.playerCharacterId)?.level;
|
||||||
|
}
|
||||||
|
|
||||||
|
function resolveCr(
|
||||||
|
c: Combatant,
|
||||||
|
getCreature: (id: CreatureId) => CreatureInfo | undefined,
|
||||||
|
): { cr: string | null; creature: CreatureInfo | undefined } {
|
||||||
|
const creature = c.creatureId ? getCreature(c.creatureId) : undefined;
|
||||||
|
const cr = creature?.cr ?? c.cr ?? null;
|
||||||
|
return { cr, creature };
|
||||||
|
}
|
||||||
|
|
||||||
|
function classifyCombatants(
|
||||||
combatants: readonly Combatant[],
|
combatants: readonly Combatant[],
|
||||||
characters: readonly PlayerCharacter[],
|
characters: readonly PlayerCharacter[],
|
||||||
): number[] {
|
getCreature: (id: CreatureId) => CreatureInfo | undefined,
|
||||||
const levels: number[] = [];
|
) {
|
||||||
|
const partyCombatants: BreakdownCombatant[] = [];
|
||||||
|
const enemyCombatants: BreakdownCombatant[] = [];
|
||||||
|
const descriptors: {
|
||||||
|
level?: number;
|
||||||
|
cr?: string;
|
||||||
|
side: "party" | "enemy";
|
||||||
|
}[] = [];
|
||||||
|
let pcCount = 0;
|
||||||
|
|
||||||
for (const c of combatants) {
|
for (const c of combatants) {
|
||||||
if (!c.playerCharacterId) continue;
|
const side = resolveSide(c);
|
||||||
const pc = characters.find((p) => p.id === c.playerCharacterId);
|
const level = resolveLevel(c, characters);
|
||||||
if (pc?.level !== undefined) levels.push(pc.level);
|
if (level !== undefined) pcCount++;
|
||||||
|
|
||||||
|
const { cr, creature } = resolveCr(c, getCreature);
|
||||||
|
|
||||||
|
if (level !== undefined || cr != null) {
|
||||||
|
descriptors.push({ level, cr: cr ?? undefined, side });
|
||||||
}
|
}
|
||||||
return levels;
|
|
||||||
|
const entry = buildBreakdownEntry(c, side, level, creature);
|
||||||
|
const target = side === "party" ? partyCombatants : enemyCombatants;
|
||||||
|
target.push(entry);
|
||||||
|
}
|
||||||
|
|
||||||
|
return { partyCombatants, enemyCombatants, descriptors, pcCount };
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,5 +1,7 @@
|
|||||||
import type {
|
import type {
|
||||||
|
AnyCreature,
|
||||||
Combatant,
|
Combatant,
|
||||||
|
CombatantDescriptor,
|
||||||
CreatureId,
|
CreatureId,
|
||||||
DifficultyResult,
|
DifficultyResult,
|
||||||
PlayerCharacter,
|
PlayerCharacter,
|
||||||
@@ -9,49 +11,58 @@ import { useMemo } from "react";
|
|||||||
import { useBestiaryContext } from "../contexts/bestiary-context.js";
|
import { useBestiaryContext } from "../contexts/bestiary-context.js";
|
||||||
import { useEncounterContext } from "../contexts/encounter-context.js";
|
import { useEncounterContext } from "../contexts/encounter-context.js";
|
||||||
import { usePlayerCharactersContext } from "../contexts/player-characters-context.js";
|
import { usePlayerCharactersContext } from "../contexts/player-characters-context.js";
|
||||||
|
import { useRulesEditionContext } from "../contexts/rules-edition-context.js";
|
||||||
|
|
||||||
function derivePartyLevels(
|
export function resolveSide(c: Combatant): "party" | "enemy" {
|
||||||
combatants: readonly Combatant[],
|
if (c.side) return c.side;
|
||||||
characters: readonly PlayerCharacter[],
|
return c.playerCharacterId ? "party" : "enemy";
|
||||||
): number[] {
|
|
||||||
const levels: number[] = [];
|
|
||||||
for (const c of combatants) {
|
|
||||||
if (!c.playerCharacterId) continue;
|
|
||||||
const pc = characters.find((p) => p.id === c.playerCharacterId);
|
|
||||||
if (pc?.level !== undefined) levels.push(pc.level);
|
|
||||||
}
|
|
||||||
return levels;
|
|
||||||
}
|
}
|
||||||
|
|
||||||
function deriveMonsterCrs(
|
function buildDescriptors(
|
||||||
combatants: readonly Combatant[],
|
combatants: readonly Combatant[],
|
||||||
getCreature: (id: CreatureId) => { cr: string } | undefined,
|
characters: readonly PlayerCharacter[],
|
||||||
): string[] {
|
getCreature: (id: CreatureId) => AnyCreature | undefined,
|
||||||
const crs: string[] = [];
|
): CombatantDescriptor[] {
|
||||||
|
const descriptors: CombatantDescriptor[] = [];
|
||||||
for (const c of combatants) {
|
for (const c of combatants) {
|
||||||
if (c.creatureId) {
|
const side = resolveSide(c);
|
||||||
const creature = getCreature(c.creatureId);
|
const level = c.playerCharacterId
|
||||||
if (creature) crs.push(creature.cr);
|
? characters.find((p) => p.id === c.playerCharacterId)?.level
|
||||||
} else if (c.cr) {
|
: undefined;
|
||||||
crs.push(c.cr);
|
const creature = c.creatureId ? getCreature(c.creatureId) : undefined;
|
||||||
|
const creatureCr =
|
||||||
|
creature && !("system" in creature) ? creature.cr : undefined;
|
||||||
|
const cr = creatureCr ?? c.cr ?? undefined;
|
||||||
|
|
||||||
|
if (level !== undefined || cr !== undefined) {
|
||||||
|
descriptors.push({ level, cr, side });
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
return crs;
|
return descriptors;
|
||||||
}
|
}
|
||||||
|
|
||||||
export function useDifficulty(): DifficultyResult | null {
|
export function useDifficulty(): DifficultyResult | null {
|
||||||
const { encounter } = useEncounterContext();
|
const { encounter } = useEncounterContext();
|
||||||
const { characters } = usePlayerCharactersContext();
|
const { characters } = usePlayerCharactersContext();
|
||||||
const { getCreature } = useBestiaryContext();
|
const { getCreature } = useBestiaryContext();
|
||||||
|
const { edition } = useRulesEditionContext();
|
||||||
|
|
||||||
return useMemo(() => {
|
return useMemo(() => {
|
||||||
const partyLevels = derivePartyLevels(encounter.combatants, characters);
|
if (edition === "pf2e") return null;
|
||||||
const monsterCrs = deriveMonsterCrs(encounter.combatants, getCreature);
|
|
||||||
|
|
||||||
if (partyLevels.length === 0 || monsterCrs.length === 0) {
|
const descriptors = buildDescriptors(
|
||||||
return null;
|
encounter.combatants,
|
||||||
}
|
characters,
|
||||||
|
getCreature,
|
||||||
|
);
|
||||||
|
|
||||||
return calculateEncounterDifficulty(partyLevels, monsterCrs);
|
const hasPartyLevel = descriptors.some(
|
||||||
}, [encounter.combatants, characters, getCreature]);
|
(d) => d.side === "party" && d.level !== undefined,
|
||||||
|
);
|
||||||
|
const hasCr = descriptors.some((d) => d.cr !== undefined);
|
||||||
|
|
||||||
|
if (!hasPartyLevel || !hasCr) return null;
|
||||||
|
|
||||||
|
return calculateEncounterDifficulty(descriptors, edition);
|
||||||
|
}, [encounter.combatants, characters, getCreature, edition]);
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -4,21 +4,23 @@ import {
|
|||||||
adjustHpUseCase,
|
adjustHpUseCase,
|
||||||
advanceTurnUseCase,
|
advanceTurnUseCase,
|
||||||
clearEncounterUseCase,
|
clearEncounterUseCase,
|
||||||
|
decrementConditionUseCase,
|
||||||
editCombatantUseCase,
|
editCombatantUseCase,
|
||||||
redoUseCase,
|
redoUseCase,
|
||||||
removeCombatantUseCase,
|
removeCombatantUseCase,
|
||||||
retreatTurnUseCase,
|
retreatTurnUseCase,
|
||||||
setAcUseCase,
|
setAcUseCase,
|
||||||
|
setConditionValueUseCase,
|
||||||
setCrUseCase,
|
setCrUseCase,
|
||||||
setHpUseCase,
|
setHpUseCase,
|
||||||
setInitiativeUseCase,
|
setInitiativeUseCase,
|
||||||
|
setSideUseCase,
|
||||||
setTempHpUseCase,
|
setTempHpUseCase,
|
||||||
toggleConcentrationUseCase,
|
toggleConcentrationUseCase,
|
||||||
toggleConditionUseCase,
|
toggleConditionUseCase,
|
||||||
undoUseCase,
|
undoUseCase,
|
||||||
} from "@initiative/application";
|
} from "@initiative/application";
|
||||||
import type {
|
import type {
|
||||||
BestiaryIndexEntry,
|
|
||||||
CombatantId,
|
CombatantId,
|
||||||
CombatantInit,
|
CombatantInit,
|
||||||
ConditionId,
|
ConditionId,
|
||||||
@@ -39,6 +41,7 @@ import {
|
|||||||
} from "@initiative/domain";
|
} from "@initiative/domain";
|
||||||
import { useCallback, useEffect, useReducer, useRef } from "react";
|
import { useCallback, useEffect, useReducer, useRef } from "react";
|
||||||
import { useAdapters } from "../contexts/adapter-context.js";
|
import { useAdapters } from "../contexts/adapter-context.js";
|
||||||
|
import type { SearchResult } from "./use-bestiary.js";
|
||||||
|
|
||||||
// -- Types --
|
// -- Types --
|
||||||
|
|
||||||
@@ -54,19 +57,31 @@ type EncounterAction =
|
|||||||
| { type: "set-temp-hp"; id: CombatantId; tempHp: number | undefined }
|
| { type: "set-temp-hp"; id: CombatantId; tempHp: number | undefined }
|
||||||
| { type: "set-ac"; id: CombatantId; value: number | undefined }
|
| { type: "set-ac"; id: CombatantId; value: number | undefined }
|
||||||
| { type: "set-cr"; id: CombatantId; value: string | undefined }
|
| { type: "set-cr"; id: CombatantId; value: string | undefined }
|
||||||
|
| { type: "set-side"; id: CombatantId; value: "party" | "enemy" }
|
||||||
| {
|
| {
|
||||||
type: "toggle-condition";
|
type: "toggle-condition";
|
||||||
id: CombatantId;
|
id: CombatantId;
|
||||||
conditionId: ConditionId;
|
conditionId: ConditionId;
|
||||||
}
|
}
|
||||||
|
| {
|
||||||
|
type: "set-condition-value";
|
||||||
|
id: CombatantId;
|
||||||
|
conditionId: ConditionId;
|
||||||
|
value: number;
|
||||||
|
}
|
||||||
|
| {
|
||||||
|
type: "decrement-condition";
|
||||||
|
id: CombatantId;
|
||||||
|
conditionId: ConditionId;
|
||||||
|
}
|
||||||
| { type: "toggle-concentration"; id: CombatantId }
|
| { type: "toggle-concentration"; id: CombatantId }
|
||||||
| { type: "clear-encounter" }
|
| { type: "clear-encounter" }
|
||||||
| { type: "undo" }
|
| { type: "undo" }
|
||||||
| { type: "redo" }
|
| { type: "redo" }
|
||||||
| { type: "add-from-bestiary"; entry: BestiaryIndexEntry }
|
| { type: "add-from-bestiary"; entry: SearchResult }
|
||||||
| {
|
| {
|
||||||
type: "add-multiple-from-bestiary";
|
type: "add-multiple-from-bestiary";
|
||||||
entry: BestiaryIndexEntry;
|
entry: SearchResult;
|
||||||
count: number;
|
count: number;
|
||||||
}
|
}
|
||||||
| { type: "add-from-player-character"; pc: PlayerCharacter }
|
| { type: "add-from-player-character"; pc: PlayerCharacter }
|
||||||
@@ -154,7 +169,7 @@ function resolveAndRename(store: EncounterStore, name: string): string {
|
|||||||
|
|
||||||
function addOneFromBestiary(
|
function addOneFromBestiary(
|
||||||
store: EncounterStore,
|
store: EncounterStore,
|
||||||
entry: BestiaryIndexEntry,
|
entry: SearchResult,
|
||||||
nextId: number,
|
nextId: number,
|
||||||
): {
|
): {
|
||||||
cId: CreatureId;
|
cId: CreatureId;
|
||||||
@@ -213,7 +228,7 @@ function handleUndoRedo(
|
|||||||
|
|
||||||
function handleAddFromBestiary(
|
function handleAddFromBestiary(
|
||||||
state: EncounterState,
|
state: EncounterState,
|
||||||
entry: BestiaryIndexEntry,
|
entry: SearchResult,
|
||||||
count: number,
|
count: number,
|
||||||
): EncounterState {
|
): EncounterState {
|
||||||
const { store, getEncounter } = makeStoreFromState(state);
|
const { store, getEncounter } = makeStoreFromState(state);
|
||||||
@@ -321,7 +336,10 @@ function dispatchEncounterAction(
|
|||||||
| { type: "set-temp-hp" }
|
| { type: "set-temp-hp" }
|
||||||
| { type: "set-ac" }
|
| { type: "set-ac" }
|
||||||
| { type: "set-cr" }
|
| { type: "set-cr" }
|
||||||
|
| { type: "set-side" }
|
||||||
| { type: "toggle-condition" }
|
| { type: "toggle-condition" }
|
||||||
|
| { type: "set-condition-value" }
|
||||||
|
| { type: "decrement-condition" }
|
||||||
| { type: "toggle-concentration" }
|
| { type: "toggle-concentration" }
|
||||||
>,
|
>,
|
||||||
): EncounterState {
|
): EncounterState {
|
||||||
@@ -364,9 +382,23 @@ function dispatchEncounterAction(
|
|||||||
case "set-cr":
|
case "set-cr":
|
||||||
result = setCrUseCase(store, action.id, action.value);
|
result = setCrUseCase(store, action.id, action.value);
|
||||||
break;
|
break;
|
||||||
|
case "set-side":
|
||||||
|
result = setSideUseCase(store, action.id, action.value);
|
||||||
|
break;
|
||||||
case "toggle-condition":
|
case "toggle-condition":
|
||||||
result = toggleConditionUseCase(store, action.id, action.conditionId);
|
result = toggleConditionUseCase(store, action.id, action.conditionId);
|
||||||
break;
|
break;
|
||||||
|
case "set-condition-value":
|
||||||
|
result = setConditionValueUseCase(
|
||||||
|
store,
|
||||||
|
action.id,
|
||||||
|
action.conditionId,
|
||||||
|
action.value,
|
||||||
|
);
|
||||||
|
break;
|
||||||
|
case "decrement-condition":
|
||||||
|
result = decrementConditionUseCase(store, action.id, action.conditionId);
|
||||||
|
break;
|
||||||
case "toggle-concentration":
|
case "toggle-concentration":
|
||||||
result = toggleConcentrationUseCase(store, action.id);
|
result = toggleConcentrationUseCase(store, action.id);
|
||||||
break;
|
break;
|
||||||
@@ -506,11 +538,26 @@ export function useEncounter() {
|
|||||||
dispatch({ type: "set-cr", id, value }),
|
dispatch({ type: "set-cr", id, value }),
|
||||||
[],
|
[],
|
||||||
),
|
),
|
||||||
|
setSide: useCallback(
|
||||||
|
(id: CombatantId, value: "party" | "enemy") =>
|
||||||
|
dispatch({ type: "set-side", id, value }),
|
||||||
|
[],
|
||||||
|
),
|
||||||
toggleCondition: useCallback(
|
toggleCondition: useCallback(
|
||||||
(id: CombatantId, conditionId: ConditionId) =>
|
(id: CombatantId, conditionId: ConditionId) =>
|
||||||
dispatch({ type: "toggle-condition", id, conditionId }),
|
dispatch({ type: "toggle-condition", id, conditionId }),
|
||||||
[],
|
[],
|
||||||
),
|
),
|
||||||
|
setConditionValue: useCallback(
|
||||||
|
(id: CombatantId, conditionId: ConditionId, value: number) =>
|
||||||
|
dispatch({ type: "set-condition-value", id, conditionId, value }),
|
||||||
|
[],
|
||||||
|
),
|
||||||
|
decrementCondition: useCallback(
|
||||||
|
(id: CombatantId, conditionId: ConditionId) =>
|
||||||
|
dispatch({ type: "decrement-condition", id, conditionId }),
|
||||||
|
[],
|
||||||
|
),
|
||||||
toggleConcentration: useCallback(
|
toggleConcentration: useCallback(
|
||||||
(id: CombatantId) => dispatch({ type: "toggle-concentration", id }),
|
(id: CombatantId) => dispatch({ type: "toggle-concentration", id }),
|
||||||
[],
|
[],
|
||||||
@@ -519,15 +566,12 @@ export function useEncounter() {
|
|||||||
() => dispatch({ type: "clear-encounter" }),
|
() => dispatch({ type: "clear-encounter" }),
|
||||||
[],
|
[],
|
||||||
),
|
),
|
||||||
addFromBestiary: useCallback(
|
addFromBestiary: useCallback((entry: SearchResult): CreatureId | null => {
|
||||||
(entry: BestiaryIndexEntry): CreatureId | null => {
|
|
||||||
dispatch({ type: "add-from-bestiary", entry });
|
dispatch({ type: "add-from-bestiary", entry });
|
||||||
return null;
|
return null;
|
||||||
},
|
}, []),
|
||||||
[],
|
|
||||||
),
|
|
||||||
addMultipleFromBestiary: useCallback(
|
addMultipleFromBestiary: useCallback(
|
||||||
(entry: BestiaryIndexEntry, count: number): CreatureId | null => {
|
(entry: SearchResult, count: number): CreatureId | null => {
|
||||||
dispatch({
|
dispatch({
|
||||||
type: "add-multiple-from-bestiary",
|
type: "add-multiple-from-bestiary",
|
||||||
entry,
|
entry,
|
||||||
|
|||||||
@@ -1,7 +1,8 @@
|
|||||||
import type { RulesEdition } from "@initiative/domain";
|
import type { RulesEdition } from "@initiative/domain";
|
||||||
import { useCallback, useSyncExternalStore } from "react";
|
import { useCallback, useSyncExternalStore } from "react";
|
||||||
|
|
||||||
const STORAGE_KEY = "initiative:rules-edition";
|
const STORAGE_KEY = "initiative:game-system";
|
||||||
|
const OLD_STORAGE_KEY = "initiative:rules-edition";
|
||||||
|
|
||||||
const listeners = new Set<() => void>();
|
const listeners = new Set<() => void>();
|
||||||
let currentEdition: RulesEdition = loadEdition();
|
let currentEdition: RulesEdition = loadEdition();
|
||||||
@@ -9,7 +10,14 @@ let currentEdition: RulesEdition = loadEdition();
|
|||||||
function loadEdition(): RulesEdition {
|
function loadEdition(): RulesEdition {
|
||||||
try {
|
try {
|
||||||
const raw = localStorage.getItem(STORAGE_KEY);
|
const raw = localStorage.getItem(STORAGE_KEY);
|
||||||
if (raw === "5e" || raw === "5.5e") return raw;
|
if (raw === "5e" || raw === "5.5e" || raw === "pf2e") return raw;
|
||||||
|
// Migrate from old key
|
||||||
|
const old = localStorage.getItem(OLD_STORAGE_KEY);
|
||||||
|
if (old === "5e" || old === "5.5e") {
|
||||||
|
localStorage.setItem(STORAGE_KEY, old);
|
||||||
|
localStorage.removeItem(OLD_STORAGE_KEY);
|
||||||
|
return old;
|
||||||
|
}
|
||||||
} catch {
|
} catch {
|
||||||
// storage unavailable
|
// storage unavailable
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -154,6 +154,47 @@ describe("loadEncounter", () => {
|
|||||||
expect(loaded?.combatants[0].cr).toBe("2");
|
expect(loaded?.combatants[0].cr).toBe("2");
|
||||||
});
|
});
|
||||||
|
|
||||||
|
it("round-trip preserves combatant side field", () => {
|
||||||
|
const result = createEncounter(
|
||||||
|
[
|
||||||
|
{
|
||||||
|
id: combatantId("c-1"),
|
||||||
|
name: "Allied Guard",
|
||||||
|
cr: "2",
|
||||||
|
side: "party",
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: combatantId("c-2"),
|
||||||
|
name: "Goblin",
|
||||||
|
side: "enemy",
|
||||||
|
},
|
||||||
|
],
|
||||||
|
0,
|
||||||
|
1,
|
||||||
|
);
|
||||||
|
if (isDomainError(result)) throw new Error("unreachable");
|
||||||
|
saveEncounter(result);
|
||||||
|
const loaded = loadEncounter();
|
||||||
|
|
||||||
|
expect(loaded).not.toBeNull();
|
||||||
|
expect(loaded?.combatants[0].side).toBe("party");
|
||||||
|
expect(loaded?.combatants[1].side).toBe("enemy");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("round-trip preserves combatant without side field as undefined", () => {
|
||||||
|
const result = createEncounter(
|
||||||
|
[{ id: combatantId("c-1"), name: "Custom" }],
|
||||||
|
0,
|
||||||
|
1,
|
||||||
|
);
|
||||||
|
if (isDomainError(result)) throw new Error("unreachable");
|
||||||
|
saveEncounter(result);
|
||||||
|
const loaded = loadEncounter();
|
||||||
|
|
||||||
|
expect(loaded).not.toBeNull();
|
||||||
|
expect(loaded?.combatants[0].side).toBeUndefined();
|
||||||
|
});
|
||||||
|
|
||||||
it("saving after modifications persists the latest state", () => {
|
it("saving after modifications persists the latest state", () => {
|
||||||
const encounter = makeEncounter();
|
const encounter = makeEncounter();
|
||||||
saveEncounter(encounter);
|
saveEncounter(encounter);
|
||||||
|
|||||||
25103
data/bestiary/pf2e-index.json
Normal file
25103
data/bestiary/pf2e-index.json
Normal file
File diff suppressed because it is too large
Load Diff
@@ -292,9 +292,9 @@ describe("toggleConditionUseCase", () => {
|
|||||||
);
|
);
|
||||||
|
|
||||||
expect(isDomainError(result)).toBe(false);
|
expect(isDomainError(result)).toBe(false);
|
||||||
expect(requireSaved(store.saved).combatants[0].conditions).toContain(
|
expect(requireSaved(store.saved).combatants[0].conditions).toContainEqual({
|
||||||
"blinded",
|
id: "blinded",
|
||||||
);
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
it("returns domain error for unknown combatant", () => {
|
it("returns domain error for unknown combatant", () => {
|
||||||
|
|||||||
21
packages/application/src/creature-initiative-modifier.ts
Normal file
21
packages/application/src/creature-initiative-modifier.ts
Normal file
@@ -0,0 +1,21 @@
|
|||||||
|
import {
|
||||||
|
type AnyCreature,
|
||||||
|
calculateInitiative,
|
||||||
|
calculatePf2eInitiative,
|
||||||
|
} from "@initiative/domain";
|
||||||
|
|
||||||
|
export function creatureInitiativeModifier(creature: AnyCreature): number {
|
||||||
|
if ("system" in creature && creature.system === "pf2e") {
|
||||||
|
return calculatePf2eInitiative(creature.perception).modifier;
|
||||||
|
}
|
||||||
|
const c = creature as {
|
||||||
|
abilities: { dex: number };
|
||||||
|
cr: string;
|
||||||
|
initiativeProficiency: number;
|
||||||
|
};
|
||||||
|
return calculateInitiative({
|
||||||
|
dexScore: c.abilities.dex,
|
||||||
|
cr: c.cr,
|
||||||
|
initiativeProficiency: c.initiativeProficiency,
|
||||||
|
}).modifier;
|
||||||
|
}
|
||||||
19
packages/application/src/decrement-condition-use-case.ts
Normal file
19
packages/application/src/decrement-condition-use-case.ts
Normal file
@@ -0,0 +1,19 @@
|
|||||||
|
import {
|
||||||
|
type CombatantId,
|
||||||
|
type ConditionId,
|
||||||
|
type DomainError,
|
||||||
|
type DomainEvent,
|
||||||
|
decrementCondition,
|
||||||
|
} from "@initiative/domain";
|
||||||
|
import type { EncounterStore } from "./ports.js";
|
||||||
|
import { runEncounterAction } from "./run-encounter-action.js";
|
||||||
|
|
||||||
|
export function decrementConditionUseCase(
|
||||||
|
store: EncounterStore,
|
||||||
|
combatantId: CombatantId,
|
||||||
|
conditionId: ConditionId,
|
||||||
|
): DomainEvent[] | DomainError {
|
||||||
|
return runEncounterAction(store, (encounter) =>
|
||||||
|
decrementCondition(encounter, combatantId, conditionId),
|
||||||
|
);
|
||||||
|
}
|
||||||
@@ -3,6 +3,7 @@ export { adjustHpUseCase } from "./adjust-hp-use-case.js";
|
|||||||
export { advanceTurnUseCase } from "./advance-turn-use-case.js";
|
export { advanceTurnUseCase } from "./advance-turn-use-case.js";
|
||||||
export { clearEncounterUseCase } from "./clear-encounter-use-case.js";
|
export { clearEncounterUseCase } from "./clear-encounter-use-case.js";
|
||||||
export { createPlayerCharacterUseCase } from "./create-player-character-use-case.js";
|
export { createPlayerCharacterUseCase } from "./create-player-character-use-case.js";
|
||||||
|
export { decrementConditionUseCase } from "./decrement-condition-use-case.js";
|
||||||
export { deletePlayerCharacterUseCase } from "./delete-player-character-use-case.js";
|
export { deletePlayerCharacterUseCase } from "./delete-player-character-use-case.js";
|
||||||
export { editCombatantUseCase } from "./edit-combatant-use-case.js";
|
export { editCombatantUseCase } from "./edit-combatant-use-case.js";
|
||||||
export { editPlayerCharacterUseCase } from "./edit-player-character-use-case.js";
|
export { editPlayerCharacterUseCase } from "./edit-player-character-use-case.js";
|
||||||
@@ -21,9 +22,11 @@ export {
|
|||||||
} from "./roll-all-initiative-use-case.js";
|
} from "./roll-all-initiative-use-case.js";
|
||||||
export { rollInitiativeUseCase } from "./roll-initiative-use-case.js";
|
export { rollInitiativeUseCase } from "./roll-initiative-use-case.js";
|
||||||
export { setAcUseCase } from "./set-ac-use-case.js";
|
export { setAcUseCase } from "./set-ac-use-case.js";
|
||||||
|
export { setConditionValueUseCase } from "./set-condition-value-use-case.js";
|
||||||
export { setCrUseCase } from "./set-cr-use-case.js";
|
export { setCrUseCase } from "./set-cr-use-case.js";
|
||||||
export { setHpUseCase } from "./set-hp-use-case.js";
|
export { setHpUseCase } from "./set-hp-use-case.js";
|
||||||
export { setInitiativeUseCase } from "./set-initiative-use-case.js";
|
export { setInitiativeUseCase } from "./set-initiative-use-case.js";
|
||||||
|
export { setSideUseCase } from "./set-side-use-case.js";
|
||||||
export { setTempHpUseCase } from "./set-temp-hp-use-case.js";
|
export { setTempHpUseCase } from "./set-temp-hp-use-case.js";
|
||||||
export { toggleConcentrationUseCase } from "./toggle-concentration-use-case.js";
|
export { toggleConcentrationUseCase } from "./toggle-concentration-use-case.js";
|
||||||
export { toggleConditionUseCase } from "./toggle-condition-use-case.js";
|
export { toggleConditionUseCase } from "./toggle-condition-use-case.js";
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
import type {
|
import type {
|
||||||
Creature,
|
AnyCreature,
|
||||||
CreatureId,
|
CreatureId,
|
||||||
Encounter,
|
Encounter,
|
||||||
PlayerCharacter,
|
PlayerCharacter,
|
||||||
@@ -12,7 +12,7 @@ export interface EncounterStore {
|
|||||||
}
|
}
|
||||||
|
|
||||||
export interface BestiarySourceCache {
|
export interface BestiarySourceCache {
|
||||||
getCreature(creatureId: CreatureId): Creature | undefined;
|
getCreature(creatureId: CreatureId): AnyCreature | undefined;
|
||||||
isSourceCached(sourceCode: string): boolean;
|
isSourceCached(sourceCode: string): boolean;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -1,7 +1,6 @@
|
|||||||
import {
|
import {
|
||||||
type Creature,
|
type AnyCreature,
|
||||||
type CreatureId,
|
type CreatureId,
|
||||||
calculateInitiative,
|
|
||||||
type DomainError,
|
type DomainError,
|
||||||
type DomainEvent,
|
type DomainEvent,
|
||||||
isDomainError,
|
isDomainError,
|
||||||
@@ -10,6 +9,7 @@ import {
|
|||||||
selectRoll,
|
selectRoll,
|
||||||
setInitiative,
|
setInitiative,
|
||||||
} from "@initiative/domain";
|
} from "@initiative/domain";
|
||||||
|
import { creatureInitiativeModifier } from "./creature-initiative-modifier.js";
|
||||||
import type { EncounterStore } from "./ports.js";
|
import type { EncounterStore } from "./ports.js";
|
||||||
|
|
||||||
export interface RollAllResult {
|
export interface RollAllResult {
|
||||||
@@ -20,7 +20,7 @@ export interface RollAllResult {
|
|||||||
export function rollAllInitiativeUseCase(
|
export function rollAllInitiativeUseCase(
|
||||||
store: EncounterStore,
|
store: EncounterStore,
|
||||||
rollDice: () => number,
|
rollDice: () => number,
|
||||||
getCreature: (id: CreatureId) => Creature | undefined,
|
getCreature: (id: CreatureId) => AnyCreature | undefined,
|
||||||
mode: RollMode = "normal",
|
mode: RollMode = "normal",
|
||||||
): RollAllResult | DomainError {
|
): RollAllResult | DomainError {
|
||||||
let encounter = store.get();
|
let encounter = store.get();
|
||||||
@@ -37,11 +37,7 @@ export function rollAllInitiativeUseCase(
|
|||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
|
|
||||||
const { modifier } = calculateInitiative({
|
const modifier = creatureInitiativeModifier(creature);
|
||||||
dexScore: creature.abilities.dex,
|
|
||||||
cr: creature.cr,
|
|
||||||
initiativeProficiency: creature.initiativeProficiency,
|
|
||||||
});
|
|
||||||
const roll1 = rollDice();
|
const roll1 = rollDice();
|
||||||
const effectiveRoll =
|
const effectiveRoll =
|
||||||
mode === "normal" ? roll1 : selectRoll(roll1, rollDice(), mode);
|
mode === "normal" ? roll1 : selectRoll(roll1, rollDice(), mode);
|
||||||
|
|||||||
@@ -1,8 +1,7 @@
|
|||||||
import {
|
import {
|
||||||
|
type AnyCreature,
|
||||||
type CombatantId,
|
type CombatantId,
|
||||||
type Creature,
|
|
||||||
type CreatureId,
|
type CreatureId,
|
||||||
calculateInitiative,
|
|
||||||
type DomainError,
|
type DomainError,
|
||||||
type DomainEvent,
|
type DomainEvent,
|
||||||
isDomainError,
|
isDomainError,
|
||||||
@@ -11,13 +10,14 @@ import {
|
|||||||
selectRoll,
|
selectRoll,
|
||||||
setInitiative,
|
setInitiative,
|
||||||
} from "@initiative/domain";
|
} from "@initiative/domain";
|
||||||
|
import { creatureInitiativeModifier } from "./creature-initiative-modifier.js";
|
||||||
import type { EncounterStore } from "./ports.js";
|
import type { EncounterStore } from "./ports.js";
|
||||||
|
|
||||||
export function rollInitiativeUseCase(
|
export function rollInitiativeUseCase(
|
||||||
store: EncounterStore,
|
store: EncounterStore,
|
||||||
combatantId: CombatantId,
|
combatantId: CombatantId,
|
||||||
diceRolls: readonly [number, ...number[]],
|
diceRolls: readonly [number, ...number[]],
|
||||||
getCreature: (id: CreatureId) => Creature | undefined,
|
getCreature: (id: CreatureId) => AnyCreature | undefined,
|
||||||
mode: RollMode = "normal",
|
mode: RollMode = "normal",
|
||||||
): DomainEvent[] | DomainError {
|
): DomainEvent[] | DomainError {
|
||||||
const encounter = store.get();
|
const encounter = store.get();
|
||||||
@@ -48,11 +48,7 @@ export function rollInitiativeUseCase(
|
|||||||
};
|
};
|
||||||
}
|
}
|
||||||
|
|
||||||
const { modifier } = calculateInitiative({
|
const modifier = creatureInitiativeModifier(creature);
|
||||||
dexScore: creature.abilities.dex,
|
|
||||||
cr: creature.cr,
|
|
||||||
initiativeProficiency: creature.initiativeProficiency,
|
|
||||||
});
|
|
||||||
const effectiveRoll =
|
const effectiveRoll =
|
||||||
mode === "normal"
|
mode === "normal"
|
||||||
? diceRolls[0]
|
? diceRolls[0]
|
||||||
|
|||||||
20
packages/application/src/set-condition-value-use-case.ts
Normal file
20
packages/application/src/set-condition-value-use-case.ts
Normal file
@@ -0,0 +1,20 @@
|
|||||||
|
import {
|
||||||
|
type CombatantId,
|
||||||
|
type ConditionId,
|
||||||
|
type DomainError,
|
||||||
|
type DomainEvent,
|
||||||
|
setConditionValue,
|
||||||
|
} from "@initiative/domain";
|
||||||
|
import type { EncounterStore } from "./ports.js";
|
||||||
|
import { runEncounterAction } from "./run-encounter-action.js";
|
||||||
|
|
||||||
|
export function setConditionValueUseCase(
|
||||||
|
store: EncounterStore,
|
||||||
|
combatantId: CombatantId,
|
||||||
|
conditionId: ConditionId,
|
||||||
|
value: number,
|
||||||
|
): DomainEvent[] | DomainError {
|
||||||
|
return runEncounterAction(store, (encounter) =>
|
||||||
|
setConditionValue(encounter, combatantId, conditionId, value),
|
||||||
|
);
|
||||||
|
}
|
||||||
18
packages/application/src/set-side-use-case.ts
Normal file
18
packages/application/src/set-side-use-case.ts
Normal file
@@ -0,0 +1,18 @@
|
|||||||
|
import {
|
||||||
|
type CombatantId,
|
||||||
|
type DomainError,
|
||||||
|
type DomainEvent,
|
||||||
|
setSide,
|
||||||
|
} from "@initiative/domain";
|
||||||
|
import type { EncounterStore } from "./ports.js";
|
||||||
|
import { runEncounterAction } from "./run-encounter-action.js";
|
||||||
|
|
||||||
|
export function setSideUseCase(
|
||||||
|
store: EncounterStore,
|
||||||
|
combatantId: CombatantId,
|
||||||
|
value: "party" | "enemy",
|
||||||
|
): DomainEvent[] | DomainError {
|
||||||
|
return runEncounterAction(store, (encounter) =>
|
||||||
|
setSide(encounter, combatantId, value),
|
||||||
|
);
|
||||||
|
}
|
||||||
@@ -54,7 +54,7 @@ describe("clearEncounter", () => {
|
|||||||
maxHp: 50,
|
maxHp: 50,
|
||||||
currentHp: 30,
|
currentHp: 30,
|
||||||
ac: 18,
|
ac: 18,
|
||||||
conditions: ["blinded", "poisoned"],
|
conditions: [{ id: "blinded" }, { id: "poisoned" }],
|
||||||
isConcentrating: true,
|
isConcentrating: true,
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
@@ -63,7 +63,7 @@ describe("clearEncounter", () => {
|
|||||||
maxHp: 25,
|
maxHp: 25,
|
||||||
currentHp: 0,
|
currentHp: 0,
|
||||||
ac: 12,
|
ac: 12,
|
||||||
conditions: ["unconscious"],
|
conditions: [{ id: "unconscious" }],
|
||||||
},
|
},
|
||||||
],
|
],
|
||||||
activeIndex: 0,
|
activeIndex: 0,
|
||||||
|
|||||||
@@ -26,25 +26,40 @@ describe("getConditionDescription", () => {
|
|||||||
);
|
);
|
||||||
});
|
});
|
||||||
|
|
||||||
it("universal conditions have both descriptions", () => {
|
it("returns pf2e description when edition is pf2e", () => {
|
||||||
const universal = CONDITION_DEFINITIONS.filter(
|
const blinded = findCondition("blinded");
|
||||||
(d) => d.edition === undefined,
|
expect(getConditionDescription(blinded, "pf2e")).toBe(
|
||||||
|
blinded.descriptionPf2e,
|
||||||
);
|
);
|
||||||
expect(universal.length).toBeGreaterThan(0);
|
});
|
||||||
for (const def of universal) {
|
|
||||||
expect(def.description).toBeTruthy();
|
it("falls back to default description for pf2e when no pf2e text", () => {
|
||||||
expect(def.description5e).toBeTruthy();
|
const paralyzed = findCondition("paralyzed");
|
||||||
|
expect(getConditionDescription(paralyzed, "pf2e")).toBe(
|
||||||
|
paralyzed.descriptionPf2e,
|
||||||
|
);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("shared D&D conditions have both description and description5e", () => {
|
||||||
|
const sharedDndConditions = CONDITION_DEFINITIONS.filter(
|
||||||
|
(d) =>
|
||||||
|
d.systems === undefined ||
|
||||||
|
(d.systems.includes("5e") && d.systems.includes("5.5e")),
|
||||||
|
);
|
||||||
|
for (const def of sharedDndConditions) {
|
||||||
|
expect(def.description, `${def.id} missing description`).toBeTruthy();
|
||||||
|
expect(def.description5e, `${def.id} missing description5e`).toBeTruthy();
|
||||||
}
|
}
|
||||||
});
|
});
|
||||||
|
|
||||||
it("edition-specific conditions have their edition description", () => {
|
it("system-specific conditions use the systems field", () => {
|
||||||
const sapped = findCondition("sapped");
|
const sapped = findCondition("sapped");
|
||||||
expect(sapped.description).toBeTruthy();
|
expect(sapped.description).toBeTruthy();
|
||||||
expect(sapped.edition).toBe("5.5e");
|
expect(sapped.systems).toContain("5.5e");
|
||||||
|
|
||||||
const slowed = findCondition("slowed");
|
const slowed = findCondition("slowed");
|
||||||
expect(slowed.description).toBeTruthy();
|
expect(slowed.description).toBeTruthy();
|
||||||
expect(slowed.edition).toBe("5.5e");
|
expect(slowed.systems).toContain("5.5e");
|
||||||
});
|
});
|
||||||
|
|
||||||
it("conditions with identical rules share the same text", () => {
|
it("conditions with identical rules share the same text", () => {
|
||||||
@@ -79,4 +94,34 @@ describe("getConditionsForEdition", () => {
|
|||||||
expect(ids5e).toContain("blinded");
|
expect(ids5e).toContain("blinded");
|
||||||
expect(ids55e).toContain("blinded");
|
expect(ids55e).toContain("blinded");
|
||||||
});
|
});
|
||||||
|
|
||||||
|
it("returns PF2e conditions for pf2e edition", () => {
|
||||||
|
const conditions = getConditionsForEdition("pf2e");
|
||||||
|
const ids = conditions.map((d) => d.id);
|
||||||
|
expect(ids).toContain("clumsy");
|
||||||
|
expect(ids).toContain("drained");
|
||||||
|
expect(ids).toContain("off-guard");
|
||||||
|
expect(ids).toContain("sickened");
|
||||||
|
expect(ids).not.toContain("charmed");
|
||||||
|
expect(ids).not.toContain("exhaustion");
|
||||||
|
expect(ids).not.toContain("grappled");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("returns D&D conditions for 5.5e", () => {
|
||||||
|
const conditions = getConditionsForEdition("5.5e");
|
||||||
|
const ids = conditions.map((d) => d.id);
|
||||||
|
expect(ids).toContain("charmed");
|
||||||
|
expect(ids).toContain("exhaustion");
|
||||||
|
expect(ids).not.toContain("clumsy");
|
||||||
|
expect(ids).not.toContain("off-guard");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("shared conditions appear in both D&D and PF2e", () => {
|
||||||
|
const dndIds = getConditionsForEdition("5.5e").map((d) => d.id);
|
||||||
|
const pf2eIds = getConditionsForEdition("pf2e").map((d) => d.id);
|
||||||
|
expect(dndIds).toContain("blinded");
|
||||||
|
expect(pf2eIds).toContain("blinded");
|
||||||
|
expect(dndIds).toContain("prone");
|
||||||
|
expect(pf2eIds).toContain("prone");
|
||||||
|
});
|
||||||
});
|
});
|
||||||
|
|||||||
@@ -36,98 +36,353 @@ describe("crToXp", () => {
|
|||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
describe("calculateEncounterDifficulty", () => {
|
/** Helper to build party-side descriptors with level. */
|
||||||
it("returns trivial when monster XP is below Low threshold", () => {
|
function party(level: number) {
|
||||||
|
return { level, side: "party" as const };
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Helper to build enemy-side descriptors with CR. */
|
||||||
|
function enemy(cr: string) {
|
||||||
|
return { cr, side: "enemy" as const };
|
||||||
|
}
|
||||||
|
|
||||||
|
describe("calculateEncounterDifficulty — 5.5e edition", () => {
|
||||||
|
it("returns tier 0 when monster XP is below Low threshold", () => {
|
||||||
// 4x level 1: Low = 200, Moderate = 300, High = 400
|
// 4x level 1: Low = 200, Moderate = 300, High = 400
|
||||||
// 1x CR 0 = 0 XP → trivial
|
// 1x CR 0 = 0 XP -> tier 0
|
||||||
const result = calculateEncounterDifficulty([1, 1, 1, 1], ["0"]);
|
const result = calculateEncounterDifficulty(
|
||||||
expect(result.tier).toBe("trivial");
|
[party(1), party(1), party(1), party(1), enemy("0")],
|
||||||
|
"5.5e",
|
||||||
|
);
|
||||||
|
expect(result.tier).toBe(0);
|
||||||
expect(result.totalMonsterXp).toBe(0);
|
expect(result.totalMonsterXp).toBe(0);
|
||||||
expect(result.partyBudget).toEqual({
|
expect(result.thresholds).toEqual([
|
||||||
low: 200,
|
{ label: "Low", value: 200 },
|
||||||
moderate: 300,
|
{ label: "Moderate", value: 300 },
|
||||||
high: 400,
|
{ label: "High", value: 400 },
|
||||||
});
|
]);
|
||||||
|
expect(result.encounterMultiplier).toBeUndefined();
|
||||||
|
expect(result.adjustedXp).toBeUndefined();
|
||||||
|
expect(result.partySizeAdjusted).toBeUndefined();
|
||||||
});
|
});
|
||||||
|
|
||||||
it("returns low for 4x level 1 vs Bugbear (CR 1)", () => {
|
it("returns tier 1 for 4x level 1 vs Bugbear (CR 1)", () => {
|
||||||
// DMG example: 4x level 1 PCs vs 1 Bugbear (CR 1, 200 XP)
|
const result = calculateEncounterDifficulty(
|
||||||
// Low = 200, Moderate = 300 → 200 >= 200 but < 300 → Low
|
[party(1), party(1), party(1), party(1), enemy("1")],
|
||||||
const result = calculateEncounterDifficulty([1, 1, 1, 1], ["1"]);
|
"5.5e",
|
||||||
expect(result.tier).toBe("low");
|
);
|
||||||
|
expect(result.tier).toBe(1);
|
||||||
expect(result.totalMonsterXp).toBe(200);
|
expect(result.totalMonsterXp).toBe(200);
|
||||||
});
|
});
|
||||||
|
|
||||||
it("returns moderate for 5x level 3 vs 1125 XP", () => {
|
it("returns tier 2 for 5x level 3 vs 1150 XP", () => {
|
||||||
// 5x level 3: Low = 750, Moderate = 1125, High = 2000
|
// 5x level 3: Low = 750, Moderate = 1125, High = 2000
|
||||||
// 1125 XP >= 1125 Moderate but < 2000 High → Moderate
|
// CR 3 (700) + CR 2 (450) = 1150 XP >= 1125 Moderate
|
||||||
// Using CR 3 (700) + CR 2 (450) = 1150 XP ≈ 1125 threshold
|
const result = calculateEncounterDifficulty(
|
||||||
// Let's use exact: 5 * 225 = 1125 moderate budget
|
[
|
||||||
// Need monsters that sum exactly to 1125: CR 3 (700) + CR 2 (450) = 1150
|
party(3),
|
||||||
const result = calculateEncounterDifficulty([3, 3, 3, 3, 3], ["3", "2"]);
|
party(3),
|
||||||
expect(result.tier).toBe("moderate");
|
party(3),
|
||||||
|
party(3),
|
||||||
|
party(3),
|
||||||
|
enemy("3"),
|
||||||
|
enemy("2"),
|
||||||
|
],
|
||||||
|
"5.5e",
|
||||||
|
);
|
||||||
|
expect(result.tier).toBe(2);
|
||||||
expect(result.totalMonsterXp).toBe(1150);
|
expect(result.totalMonsterXp).toBe(1150);
|
||||||
expect(result.partyBudget.moderate).toBe(1125);
|
expect(result.thresholds[1].value).toBe(1125);
|
||||||
});
|
});
|
||||||
|
|
||||||
it("returns high when XP meets High threshold", () => {
|
it("returns tier 3 when XP meets High threshold", () => {
|
||||||
// 4x level 1: High = 400
|
// 4x level 1: High = 400
|
||||||
// 2x CR 1 = 400 XP → High
|
// 2x CR 1 = 400 XP -> tier 3
|
||||||
const result = calculateEncounterDifficulty([1, 1, 1, 1], ["1", "1"]);
|
const result = calculateEncounterDifficulty(
|
||||||
expect(result.tier).toBe("high");
|
[party(1), party(1), party(1), party(1), enemy("1"), enemy("1")],
|
||||||
|
"5.5e",
|
||||||
|
);
|
||||||
|
expect(result.tier).toBe(3);
|
||||||
expect(result.totalMonsterXp).toBe(400);
|
expect(result.totalMonsterXp).toBe(400);
|
||||||
});
|
});
|
||||||
|
|
||||||
it("caps at high when XP far exceeds threshold", () => {
|
it("caps at tier 3 when XP far exceeds threshold", () => {
|
||||||
// 4x level 1: High = 400
|
const result = calculateEncounterDifficulty(
|
||||||
// CR 30 = 155000 XP → still High (no tier above)
|
[party(1), party(1), party(1), party(1), enemy("30")],
|
||||||
const result = calculateEncounterDifficulty([1, 1, 1, 1], ["30"]);
|
"5.5e",
|
||||||
expect(result.tier).toBe("high");
|
);
|
||||||
|
expect(result.tier).toBe(3);
|
||||||
expect(result.totalMonsterXp).toBe(155000);
|
expect(result.totalMonsterXp).toBe(155000);
|
||||||
});
|
});
|
||||||
|
|
||||||
it("handles mixed party levels", () => {
|
it("handles mixed party levels", () => {
|
||||||
// 3x level 3 + 1x level 2
|
// 3x level 3 + 1x level 2
|
||||||
// level 3: low=150, mod=225, high=400 (x3 = 450, 675, 1200)
|
|
||||||
// level 2: low=100, mod=150, high=200 (x1 = 100, 150, 200)
|
|
||||||
// Total: low=550, mod=825, high=1400
|
// Total: low=550, mod=825, high=1400
|
||||||
const result = calculateEncounterDifficulty([3, 3, 3, 2], ["3"]);
|
const result = calculateEncounterDifficulty(
|
||||||
expect(result.partyBudget).toEqual({
|
[party(3), party(3), party(3), party(2), enemy("3")],
|
||||||
low: 550,
|
"5.5e",
|
||||||
moderate: 825,
|
);
|
||||||
high: 1400,
|
expect(result.thresholds).toEqual([
|
||||||
});
|
{ label: "Low", value: 550 },
|
||||||
|
{ label: "Moderate", value: 825 },
|
||||||
|
{ label: "High", value: 1400 },
|
||||||
|
]);
|
||||||
expect(result.totalMonsterXp).toBe(700);
|
expect(result.totalMonsterXp).toBe(700);
|
||||||
expect(result.tier).toBe("low");
|
expect(result.tier).toBe(1);
|
||||||
});
|
});
|
||||||
|
|
||||||
it("returns trivial with empty monster array", () => {
|
it("returns tier 0 with no enemies", () => {
|
||||||
const result = calculateEncounterDifficulty([5, 5], []);
|
const result = calculateEncounterDifficulty([party(5), party(5)], "5.5e");
|
||||||
expect(result.tier).toBe("trivial");
|
expect(result.tier).toBe(0);
|
||||||
expect(result.totalMonsterXp).toBe(0);
|
expect(result.totalMonsterXp).toBe(0);
|
||||||
});
|
});
|
||||||
|
|
||||||
it("returns high with empty party array (zero budget thresholds)", () => {
|
it("returns tier 3 with no party levels (zero budget thresholds)", () => {
|
||||||
// Domain function treats empty party as zero budgets — any XP exceeds all thresholds.
|
const result = calculateEncounterDifficulty([enemy("1")], "5.5e");
|
||||||
// The useDifficulty hook guards this path by returning null when no leveled PCs exist.
|
expect(result.tier).toBe(3);
|
||||||
const result = calculateEncounterDifficulty([], ["1"]);
|
|
||||||
expect(result.tier).toBe("high");
|
|
||||||
expect(result.totalMonsterXp).toBe(200);
|
expect(result.totalMonsterXp).toBe(200);
|
||||||
expect(result.partyBudget).toEqual({ low: 0, moderate: 0, high: 0 });
|
expect(result.thresholds).toEqual([
|
||||||
|
{ label: "Low", value: 0 },
|
||||||
|
{ label: "Moderate", value: 0 },
|
||||||
|
{ label: "High", value: 0 },
|
||||||
|
]);
|
||||||
});
|
});
|
||||||
|
|
||||||
it("handles fractional CRs", () => {
|
it("handles fractional CRs", () => {
|
||||||
const result = calculateEncounterDifficulty(
|
const result = calculateEncounterDifficulty(
|
||||||
[1, 1, 1, 1],
|
[
|
||||||
["1/8", "1/4", "1/2"],
|
party(1),
|
||||||
|
party(1),
|
||||||
|
party(1),
|
||||||
|
party(1),
|
||||||
|
enemy("1/8"),
|
||||||
|
enemy("1/4"),
|
||||||
|
enemy("1/2"),
|
||||||
|
],
|
||||||
|
"5.5e",
|
||||||
);
|
);
|
||||||
expect(result.totalMonsterXp).toBe(175); // 25 + 50 + 100
|
expect(result.totalMonsterXp).toBe(175); // 25 + 50 + 100
|
||||||
expect(result.tier).toBe("trivial"); // 175 < 200 Low
|
expect(result.tier).toBe(0); // 175 < 200 Low
|
||||||
});
|
});
|
||||||
|
|
||||||
it("ignores unknown CRs (0 XP)", () => {
|
it("ignores unknown CRs (0 XP)", () => {
|
||||||
const result = calculateEncounterDifficulty([1, 1, 1, 1], ["unknown"]);
|
const result = calculateEncounterDifficulty(
|
||||||
|
[party(1), party(1), party(1), party(1), enemy("unknown")],
|
||||||
|
"5.5e",
|
||||||
|
);
|
||||||
expect(result.totalMonsterXp).toBe(0);
|
expect(result.totalMonsterXp).toBe(0);
|
||||||
expect(result.tier).toBe("trivial");
|
expect(result.tier).toBe(0);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("subtracts XP for party-side combatant with CR", () => {
|
||||||
|
// 4x level 1 party, 1 enemy CR 2 (450 XP), 1 party CR 1 (200 XP)
|
||||||
|
// Net = 450 - 200 = 250
|
||||||
|
const result = calculateEncounterDifficulty(
|
||||||
|
[
|
||||||
|
party(1),
|
||||||
|
party(1),
|
||||||
|
party(1),
|
||||||
|
party(1),
|
||||||
|
enemy("2"),
|
||||||
|
{ cr: "1", side: "party" },
|
||||||
|
],
|
||||||
|
"5.5e",
|
||||||
|
);
|
||||||
|
expect(result.totalMonsterXp).toBe(250);
|
||||||
|
expect(result.tier).toBe(1); // 250 >= 200 Low, < 300 Moderate
|
||||||
|
});
|
||||||
|
|
||||||
|
it("floors net monster XP at 0", () => {
|
||||||
|
// Party ally has more XP than enemy
|
||||||
|
const result = calculateEncounterDifficulty(
|
||||||
|
[
|
||||||
|
party(1),
|
||||||
|
{ cr: "5", side: "party" }, // 1800 XP subtracted
|
||||||
|
enemy("1"), // 200 XP added
|
||||||
|
],
|
||||||
|
"5.5e",
|
||||||
|
);
|
||||||
|
expect(result.totalMonsterXp).toBe(0);
|
||||||
|
expect(result.tier).toBe(0);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("dual contribution: combatant with both level and CR on party side", () => {
|
||||||
|
// Party combatant with level 1 AND CR 1 on party side
|
||||||
|
// Level contributes to budget, CR subtracts from monster XP
|
||||||
|
const result = calculateEncounterDifficulty(
|
||||||
|
[
|
||||||
|
{ level: 1, cr: "1", side: "party" }, // budget += lv1, monsterXp -= 200
|
||||||
|
enemy("2"), // monsterXp += 450
|
||||||
|
],
|
||||||
|
"5.5e",
|
||||||
|
);
|
||||||
|
expect(result.thresholds).toEqual([
|
||||||
|
{ label: "Low", value: 50 },
|
||||||
|
{ label: "Moderate", value: 75 },
|
||||||
|
{ label: "High", value: 100 },
|
||||||
|
]);
|
||||||
|
expect(result.totalMonsterXp).toBe(250); // 450 - 200
|
||||||
|
});
|
||||||
|
|
||||||
|
it("enemy-side combatant with level does NOT contribute to budget", () => {
|
||||||
|
const result = calculateEncounterDifficulty(
|
||||||
|
[party(1), { level: 5, side: "enemy" }, enemy("1")],
|
||||||
|
"5.5e",
|
||||||
|
);
|
||||||
|
// Only level 1 party contributes to budget
|
||||||
|
expect(result.thresholds).toEqual([
|
||||||
|
{ label: "Low", value: 50 },
|
||||||
|
{ label: "Moderate", value: 75 },
|
||||||
|
{ label: "High", value: 100 },
|
||||||
|
]);
|
||||||
|
expect(result.totalMonsterXp).toBe(200);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("mixed sides calculate correctly", () => {
|
||||||
|
// 2 party PCs (level 3), 1 party ally (CR 1, 200 XP), 2 enemies (CR 2, 450 each)
|
||||||
|
// Budget: 2x level 3 = low 300, mod 450, high 800
|
||||||
|
// Monster XP: 900 - 200 = 700
|
||||||
|
const result = calculateEncounterDifficulty(
|
||||||
|
[party(3), party(3), { cr: "1", side: "party" }, enemy("2"), enemy("2")],
|
||||||
|
"5.5e",
|
||||||
|
);
|
||||||
|
expect(result.thresholds).toEqual([
|
||||||
|
{ label: "Low", value: 300 },
|
||||||
|
{ label: "Moderate", value: 450 },
|
||||||
|
{ label: "High", value: 800 },
|
||||||
|
]);
|
||||||
|
expect(result.totalMonsterXp).toBe(700);
|
||||||
|
expect(result.tier).toBe(2); // 700 >= 450 Moderate, < 800 High
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe("calculateEncounterDifficulty — 2014 edition", () => {
|
||||||
|
it("uses 2014 XP thresholds table", () => {
|
||||||
|
// 4x level 1: Easy=100, Medium=200, Hard=300, Deadly=400
|
||||||
|
// 1 enemy CR 1 = 200 XP, x1 multiplier = 200 adjusted
|
||||||
|
// 200 >= 200 Medium → tier 1
|
||||||
|
const result = calculateEncounterDifficulty(
|
||||||
|
[party(1), party(1), party(1), party(1), enemy("1")],
|
||||||
|
"5e",
|
||||||
|
);
|
||||||
|
expect(result.tier).toBe(1);
|
||||||
|
expect(result.thresholds).toEqual([
|
||||||
|
{ label: "Easy", value: 100 },
|
||||||
|
{ label: "Medium", value: 200 },
|
||||||
|
{ label: "Hard", value: 300 },
|
||||||
|
{ label: "Deadly", value: 400 },
|
||||||
|
]);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("applies encounter multiplier for 3 monsters (x2)", () => {
|
||||||
|
const result = calculateEncounterDifficulty(
|
||||||
|
[
|
||||||
|
party(1),
|
||||||
|
party(1),
|
||||||
|
party(1),
|
||||||
|
party(1),
|
||||||
|
enemy("1/8"),
|
||||||
|
enemy("1/8"),
|
||||||
|
enemy("1/8"),
|
||||||
|
],
|
||||||
|
"5e",
|
||||||
|
);
|
||||||
|
// Base: 75 XP, 3 monsters → x2 = 150 adjusted
|
||||||
|
expect(result.totalMonsterXp).toBe(75);
|
||||||
|
expect(result.encounterMultiplier).toBe(2);
|
||||||
|
expect(result.adjustedXp).toBe(150);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("shifts multiplier up for fewer than 3 PCs", () => {
|
||||||
|
const result = calculateEncounterDifficulty(
|
||||||
|
[party(1), party(1), enemy("1")],
|
||||||
|
"5e",
|
||||||
|
);
|
||||||
|
// 1 monster, 2 PCs → base x1 shifts up to x1.5
|
||||||
|
expect(result.encounterMultiplier).toBe(1.5);
|
||||||
|
expect(result.partySizeAdjusted).toBe(true);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("shifts multiplier down for 6+ PCs", () => {
|
||||||
|
const result = calculateEncounterDifficulty(
|
||||||
|
[
|
||||||
|
party(1),
|
||||||
|
party(1),
|
||||||
|
party(1),
|
||||||
|
party(1),
|
||||||
|
party(1),
|
||||||
|
party(1),
|
||||||
|
enemy("1"),
|
||||||
|
enemy("1"),
|
||||||
|
enemy("1"),
|
||||||
|
],
|
||||||
|
"5e",
|
||||||
|
);
|
||||||
|
// 3 monsters, 6 PCs → base x2 shifts down to x1.5
|
||||||
|
expect(result.encounterMultiplier).toBe(1.5);
|
||||||
|
expect(result.partySizeAdjusted).toBe(true);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("shifts multiplier to x5 for 15+ monsters with <3 PCs", () => {
|
||||||
|
const result = calculateEncounterDifficulty(
|
||||||
|
[party(1), party(1), ...Array.from({ length: 15 }, () => enemy("0"))],
|
||||||
|
"5e",
|
||||||
|
);
|
||||||
|
// 15+ monsters = x4 base, shift up → x5
|
||||||
|
expect(result.encounterMultiplier).toBe(5);
|
||||||
|
expect(result.partySizeAdjusted).toBe(true);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("shifts multiplier to x0.5 for 1 monster with 6+ PCs", () => {
|
||||||
|
const result = calculateEncounterDifficulty(
|
||||||
|
[party(1), party(1), party(1), party(1), party(1), party(1), enemy("1")],
|
||||||
|
"5e",
|
||||||
|
);
|
||||||
|
expect(result.encounterMultiplier).toBe(0.5);
|
||||||
|
expect(result.partySizeAdjusted).toBe(true);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("only counts enemy-side combatants for monster count", () => {
|
||||||
|
const result = calculateEncounterDifficulty(
|
||||||
|
[
|
||||||
|
party(1),
|
||||||
|
party(1),
|
||||||
|
party(1),
|
||||||
|
party(1),
|
||||||
|
{ cr: "1", side: "party" },
|
||||||
|
enemy("1"),
|
||||||
|
enemy("1"),
|
||||||
|
enemy("1"),
|
||||||
|
],
|
||||||
|
"5e",
|
||||||
|
);
|
||||||
|
// 3 enemy monsters → x2, NOT 4
|
||||||
|
expect(result.encounterMultiplier).toBe(2);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("returns tier 0 when adjusted XP meets Easy but not Medium", () => {
|
||||||
|
// 4x level 1: Easy=100, Medium=200
|
||||||
|
// 1 enemy CR 1/2 = 100 XP, x1 multiplier = 100 adjusted
|
||||||
|
// 100 >= Easy(100) but < Medium(200) → tier 0
|
||||||
|
const result = calculateEncounterDifficulty(
|
||||||
|
[party(1), party(1), party(1), party(1), enemy("1/2")],
|
||||||
|
"5e",
|
||||||
|
);
|
||||||
|
expect(result.tier).toBe(0);
|
||||||
|
expect(result.adjustedXp).toBe(100);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("returns no party size adjustment for standard party (3-5)", () => {
|
||||||
|
const result = calculateEncounterDifficulty(
|
||||||
|
[party(1), party(1), party(1), party(1), enemy("1")],
|
||||||
|
"5e",
|
||||||
|
);
|
||||||
|
expect(result.partySizeAdjusted).toBe(false);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("returns undefined multiplier/adjustedXp for 5.5e", () => {
|
||||||
|
const result = calculateEncounterDifficulty([party(1), enemy("1")], "5.5e");
|
||||||
|
expect(result.encounterMultiplier).toBeUndefined();
|
||||||
|
expect(result.adjustedXp).toBeUndefined();
|
||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|||||||
@@ -1,6 +1,7 @@
|
|||||||
import { describe, expect, it } from "vitest";
|
import { describe, expect, it } from "vitest";
|
||||||
import {
|
import {
|
||||||
calculateInitiative,
|
calculateInitiative,
|
||||||
|
calculatePf2eInitiative,
|
||||||
formatInitiativeModifier,
|
formatInitiativeModifier,
|
||||||
} from "../initiative.js";
|
} from "../initiative.js";
|
||||||
|
|
||||||
@@ -93,6 +94,26 @@ describe("calculateInitiative", () => {
|
|||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|
||||||
|
describe("calculatePf2eInitiative", () => {
|
||||||
|
it("returns perception as both modifier and passive", () => {
|
||||||
|
const result = calculatePf2eInitiative(11);
|
||||||
|
expect(result.modifier).toBe(11);
|
||||||
|
expect(result.passive).toBe(11);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("handles zero perception", () => {
|
||||||
|
const result = calculatePf2eInitiative(0);
|
||||||
|
expect(result.modifier).toBe(0);
|
||||||
|
expect(result.passive).toBe(0);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("handles negative perception", () => {
|
||||||
|
const result = calculatePf2eInitiative(-2);
|
||||||
|
expect(result.modifier).toBe(-2);
|
||||||
|
expect(result.passive).toBe(-2);
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
describe("formatInitiativeModifier", () => {
|
describe("formatInitiativeModifier", () => {
|
||||||
it("formats positive modifier with plus sign", () => {
|
it("formats positive modifier with plus sign", () => {
|
||||||
expect(formatInitiativeModifier(7)).toBe("+7");
|
expect(formatInitiativeModifier(7)).toBe("+7");
|
||||||
|
|||||||
@@ -35,7 +35,7 @@ describe("rehydrateCombatant", () => {
|
|||||||
expect(result?.maxHp).toBe(7);
|
expect(result?.maxHp).toBe(7);
|
||||||
expect(result?.currentHp).toBe(5);
|
expect(result?.currentHp).toBe(5);
|
||||||
expect(result?.tempHp).toBe(3);
|
expect(result?.tempHp).toBe(3);
|
||||||
expect(result?.conditions).toEqual(["poisoned"]);
|
expect(result?.conditions).toEqual([{ id: "poisoned" }]);
|
||||||
expect(result?.isConcentrating).toBe(true);
|
expect(result?.isConcentrating).toBe(true);
|
||||||
expect(result?.creatureId).toBe("creature-goblin");
|
expect(result?.creatureId).toBe("creature-goblin");
|
||||||
expect(result?.color).toBe("red");
|
expect(result?.color).toBe("red");
|
||||||
@@ -165,7 +165,45 @@ describe("rehydrateCombatant", () => {
|
|||||||
...minimalCombatant(),
|
...minimalCombatant(),
|
||||||
conditions: ["poisoned", "fake", "blinded"],
|
conditions: ["poisoned", "fake", "blinded"],
|
||||||
});
|
});
|
||||||
expect(result?.conditions).toEqual(["poisoned", "blinded"]);
|
expect(result?.conditions).toEqual([
|
||||||
|
{ id: "poisoned" },
|
||||||
|
{ id: "blinded" },
|
||||||
|
]);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("converts old bare string format to ConditionEntry", () => {
|
||||||
|
const result = rehydrateCombatant({
|
||||||
|
...minimalCombatant(),
|
||||||
|
conditions: ["blinded", "prone"],
|
||||||
|
});
|
||||||
|
expect(result?.conditions).toEqual([{ id: "blinded" }, { id: "prone" }]);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("passes through new ConditionEntry format with values", () => {
|
||||||
|
const result = rehydrateCombatant({
|
||||||
|
...minimalCombatant(),
|
||||||
|
conditions: [{ id: "blinded" }, { id: "frightened", value: 2 }],
|
||||||
|
});
|
||||||
|
expect(result?.conditions).toEqual([
|
||||||
|
{ id: "blinded" },
|
||||||
|
{ id: "frightened", value: 2 },
|
||||||
|
]);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("handles mixed old and new format entries", () => {
|
||||||
|
const result = rehydrateCombatant({
|
||||||
|
...minimalCombatant(),
|
||||||
|
conditions: ["blinded", { id: "prone" }],
|
||||||
|
});
|
||||||
|
expect(result?.conditions).toEqual([{ id: "blinded" }, { id: "prone" }]);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("drops ConditionEntry with invalid value", () => {
|
||||||
|
const result = rehydrateCombatant({
|
||||||
|
...minimalCombatant(),
|
||||||
|
conditions: [{ id: "blinded", value: -1 }],
|
||||||
|
});
|
||||||
|
expect(result?.conditions).toEqual([{ id: "blinded" }]);
|
||||||
});
|
});
|
||||||
|
|
||||||
it("drops invalid color — keeps combatant", () => {
|
it("drops invalid color — keeps combatant", () => {
|
||||||
@@ -241,6 +279,28 @@ describe("rehydrateCombatant", () => {
|
|||||||
expect(result?.cr).toBeUndefined();
|
expect(result?.cr).toBeUndefined();
|
||||||
});
|
});
|
||||||
|
|
||||||
|
it("preserves valid side field", () => {
|
||||||
|
for (const side of ["party", "enemy"]) {
|
||||||
|
const result = rehydrateCombatant({ ...minimalCombatant(), side });
|
||||||
|
expect(result).not.toBeNull();
|
||||||
|
expect(result?.side).toBe(side);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
it("drops invalid side field", () => {
|
||||||
|
for (const side of ["ally", "", 42, null, true]) {
|
||||||
|
const result = rehydrateCombatant({ ...minimalCombatant(), side });
|
||||||
|
expect(result).not.toBeNull();
|
||||||
|
expect(result?.side).toBeUndefined();
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
it("combatant without side rehydrates as before", () => {
|
||||||
|
const result = rehydrateCombatant(minimalCombatant());
|
||||||
|
expect(result).not.toBeNull();
|
||||||
|
expect(result?.side).toBeUndefined();
|
||||||
|
});
|
||||||
|
|
||||||
it("drops invalid tempHp — keeps combatant", () => {
|
it("drops invalid tempHp — keeps combatant", () => {
|
||||||
for (const tempHp of [-1, 1.5, "3"]) {
|
for (const tempHp of [-1, 1.5, "3"]) {
|
||||||
const result = rehydrateCombatant({
|
const result = rehydrateCombatant({
|
||||||
|
|||||||
115
packages/domain/src/__tests__/set-side.test.ts
Normal file
115
packages/domain/src/__tests__/set-side.test.ts
Normal file
@@ -0,0 +1,115 @@
|
|||||||
|
import { describe, expect, it } from "vitest";
|
||||||
|
import { setSide } from "../set-side.js";
|
||||||
|
import type { Combatant, Encounter } from "../types.js";
|
||||||
|
import { combatantId, isDomainError } from "../types.js";
|
||||||
|
import { expectDomainError } from "./test-helpers.js";
|
||||||
|
|
||||||
|
function makeCombatant(name: string, side?: "party" | "enemy"): Combatant {
|
||||||
|
return side === undefined
|
||||||
|
? { id: combatantId(name), name }
|
||||||
|
: { id: combatantId(name), name, side };
|
||||||
|
}
|
||||||
|
|
||||||
|
function enc(
|
||||||
|
combatants: Combatant[],
|
||||||
|
activeIndex = 0,
|
||||||
|
roundNumber = 1,
|
||||||
|
): Encounter {
|
||||||
|
return { combatants, activeIndex, roundNumber };
|
||||||
|
}
|
||||||
|
|
||||||
|
function successResult(
|
||||||
|
encounter: Encounter,
|
||||||
|
id: string,
|
||||||
|
value: "party" | "enemy",
|
||||||
|
) {
|
||||||
|
const result = setSide(encounter, combatantId(id), value);
|
||||||
|
if (isDomainError(result)) {
|
||||||
|
throw new Error(`Expected success, got error: ${result.message}`);
|
||||||
|
}
|
||||||
|
return result;
|
||||||
|
}
|
||||||
|
|
||||||
|
describe("setSide", () => {
|
||||||
|
it("sets side to party", () => {
|
||||||
|
const e = enc([makeCombatant("A"), makeCombatant("B")]);
|
||||||
|
const { encounter, events } = successResult(e, "A", "party");
|
||||||
|
|
||||||
|
expect(encounter.combatants[0].side).toBe("party");
|
||||||
|
expect(events).toEqual([
|
||||||
|
{
|
||||||
|
type: "SideSet",
|
||||||
|
combatantId: combatantId("A"),
|
||||||
|
previousSide: undefined,
|
||||||
|
newSide: "party",
|
||||||
|
},
|
||||||
|
]);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("sets side to enemy", () => {
|
||||||
|
const e = enc([makeCombatant("A")]);
|
||||||
|
const { encounter } = successResult(e, "A", "enemy");
|
||||||
|
|
||||||
|
expect(encounter.combatants[0].side).toBe("enemy");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("records previous side in event", () => {
|
||||||
|
const e = enc([makeCombatant("A", "party")]);
|
||||||
|
const { events } = successResult(e, "A", "enemy");
|
||||||
|
|
||||||
|
expect(events[0]).toMatchObject({
|
||||||
|
previousSide: "party",
|
||||||
|
newSide: "enemy",
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
it("returns error for nonexistent combatant", () => {
|
||||||
|
const e = enc([makeCombatant("A")]);
|
||||||
|
const result = setSide(e, combatantId("nonexistent"), "party");
|
||||||
|
|
||||||
|
expectDomainError(result, "combatant-not-found");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("preserves other fields when setting side", () => {
|
||||||
|
const combatant: Combatant = {
|
||||||
|
id: combatantId("A"),
|
||||||
|
name: "Aria",
|
||||||
|
initiative: 15,
|
||||||
|
maxHp: 20,
|
||||||
|
currentHp: 18,
|
||||||
|
ac: 14,
|
||||||
|
cr: "2",
|
||||||
|
};
|
||||||
|
const e = enc([combatant]);
|
||||||
|
const { encounter } = successResult(e, "A", "party");
|
||||||
|
|
||||||
|
const updated = encounter.combatants[0];
|
||||||
|
expect(updated.side).toBe("party");
|
||||||
|
expect(updated.name).toBe("Aria");
|
||||||
|
expect(updated.initiative).toBe(15);
|
||||||
|
expect(updated.cr).toBe("2");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("does not reorder combatants", () => {
|
||||||
|
const e = enc([makeCombatant("A"), makeCombatant("B")]);
|
||||||
|
const { encounter } = successResult(e, "B", "party");
|
||||||
|
|
||||||
|
expect(encounter.combatants[0].id).toBe(combatantId("A"));
|
||||||
|
expect(encounter.combatants[1].id).toBe(combatantId("B"));
|
||||||
|
});
|
||||||
|
|
||||||
|
it("preserves activeIndex and roundNumber", () => {
|
||||||
|
const e = enc([makeCombatant("A"), makeCombatant("B")], 1, 5);
|
||||||
|
const { encounter } = successResult(e, "A", "party");
|
||||||
|
|
||||||
|
expect(encounter.activeIndex).toBe(1);
|
||||||
|
expect(encounter.roundNumber).toBe(5);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("does not mutate input encounter", () => {
|
||||||
|
const e = enc([makeCombatant("A")]);
|
||||||
|
const original = JSON.parse(JSON.stringify(e));
|
||||||
|
setSide(e, combatantId("A"), "party");
|
||||||
|
expect(e).toEqual(original);
|
||||||
|
});
|
||||||
|
});
|
||||||
@@ -1,14 +1,18 @@
|
|||||||
import { describe, expect, it } from "vitest";
|
import { describe, expect, it } from "vitest";
|
||||||
import type { ConditionId } from "../conditions.js";
|
import type { ConditionEntry, ConditionId } from "../conditions.js";
|
||||||
import { CONDITION_DEFINITIONS } from "../conditions.js";
|
import { CONDITION_DEFINITIONS } from "../conditions.js";
|
||||||
import { toggleCondition } from "../toggle-condition.js";
|
import {
|
||||||
|
decrementCondition,
|
||||||
|
setConditionValue,
|
||||||
|
toggleCondition,
|
||||||
|
} from "../toggle-condition.js";
|
||||||
import type { Combatant, Encounter } from "../types.js";
|
import type { Combatant, Encounter } from "../types.js";
|
||||||
import { combatantId, isDomainError } from "../types.js";
|
import { combatantId, isDomainError } from "../types.js";
|
||||||
import { expectDomainError } from "./test-helpers.js";
|
import { expectDomainError } from "./test-helpers.js";
|
||||||
|
|
||||||
function makeCombatant(
|
function makeCombatant(
|
||||||
name: string,
|
name: string,
|
||||||
conditions?: readonly ConditionId[],
|
conditions?: readonly ConditionEntry[],
|
||||||
): Combatant {
|
): Combatant {
|
||||||
return conditions
|
return conditions
|
||||||
? { id: combatantId(name), name, conditions }
|
? { id: combatantId(name), name, conditions }
|
||||||
@@ -32,7 +36,7 @@ describe("toggleCondition", () => {
|
|||||||
const e = enc([makeCombatant("A")]);
|
const e = enc([makeCombatant("A")]);
|
||||||
const { encounter, events } = success(e, "A", "blinded");
|
const { encounter, events } = success(e, "A", "blinded");
|
||||||
|
|
||||||
expect(encounter.combatants[0].conditions).toEqual(["blinded"]);
|
expect(encounter.combatants[0].conditions).toEqual([{ id: "blinded" }]);
|
||||||
expect(events).toEqual([
|
expect(events).toEqual([
|
||||||
{
|
{
|
||||||
type: "ConditionAdded",
|
type: "ConditionAdded",
|
||||||
@@ -43,7 +47,7 @@ describe("toggleCondition", () => {
|
|||||||
});
|
});
|
||||||
|
|
||||||
it("removes a condition when already present", () => {
|
it("removes a condition when already present", () => {
|
||||||
const e = enc([makeCombatant("A", ["blinded"])]);
|
const e = enc([makeCombatant("A", [{ id: "blinded" }])]);
|
||||||
const { encounter, events } = success(e, "A", "blinded");
|
const { encounter, events } = success(e, "A", "blinded");
|
||||||
|
|
||||||
expect(encounter.combatants[0].conditions).toBeUndefined();
|
expect(encounter.combatants[0].conditions).toBeUndefined();
|
||||||
@@ -57,14 +61,17 @@ describe("toggleCondition", () => {
|
|||||||
});
|
});
|
||||||
|
|
||||||
it("maintains definition order when adding conditions", () => {
|
it("maintains definition order when adding conditions", () => {
|
||||||
const e = enc([makeCombatant("A", ["poisoned"])]);
|
const e = enc([makeCombatant("A", [{ id: "poisoned" }])]);
|
||||||
const { encounter } = success(e, "A", "blinded");
|
const { encounter } = success(e, "A", "blinded");
|
||||||
|
|
||||||
expect(encounter.combatants[0].conditions).toEqual(["blinded", "poisoned"]);
|
expect(encounter.combatants[0].conditions).toEqual([
|
||||||
|
{ id: "blinded" },
|
||||||
|
{ id: "poisoned" },
|
||||||
|
]);
|
||||||
});
|
});
|
||||||
|
|
||||||
it("prevents duplicate conditions", () => {
|
it("prevents duplicate conditions", () => {
|
||||||
const e = enc([makeCombatant("A", ["blinded"])]);
|
const e = enc([makeCombatant("A", [{ id: "blinded" }])]);
|
||||||
// Toggling blinded again removes it, not duplicates
|
// Toggling blinded again removes it, not duplicates
|
||||||
const { encounter } = success(e, "A", "blinded");
|
const { encounter } = success(e, "A", "blinded");
|
||||||
expect(encounter.combatants[0].conditions).toBeUndefined();
|
expect(encounter.combatants[0].conditions).toBeUndefined();
|
||||||
@@ -96,7 +103,7 @@ describe("toggleCondition", () => {
|
|||||||
});
|
});
|
||||||
|
|
||||||
it("normalizes empty array to undefined on removal", () => {
|
it("normalizes empty array to undefined on removal", () => {
|
||||||
const e = enc([makeCombatant("A", ["charmed"])]);
|
const e = enc([makeCombatant("A", [{ id: "charmed" }])]);
|
||||||
const { encounter } = success(e, "A", "charmed");
|
const { encounter } = success(e, "A", "charmed");
|
||||||
|
|
||||||
expect(encounter.combatants[0].conditions).toBeUndefined();
|
expect(encounter.combatants[0].conditions).toBeUndefined();
|
||||||
@@ -110,6 +117,91 @@ describe("toggleCondition", () => {
|
|||||||
const result = success(e, "A", cond);
|
const result = success(e, "A", cond);
|
||||||
e = result.encounter;
|
e = result.encounter;
|
||||||
}
|
}
|
||||||
expect(e.combatants[0].conditions).toEqual(order);
|
expect(e.combatants[0].conditions).toEqual(order.map((id) => ({ id })));
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe("setConditionValue", () => {
|
||||||
|
it("adds a valued condition at the specified value", () => {
|
||||||
|
const e = enc([makeCombatant("A")]);
|
||||||
|
const result = setConditionValue(e, combatantId("A"), "frightened", 2);
|
||||||
|
if (isDomainError(result)) throw new Error(result.message);
|
||||||
|
|
||||||
|
expect(result.encounter.combatants[0].conditions).toEqual([
|
||||||
|
{ id: "frightened", value: 2 },
|
||||||
|
]);
|
||||||
|
expect(result.events).toEqual([
|
||||||
|
{
|
||||||
|
type: "ConditionAdded",
|
||||||
|
combatantId: combatantId("A"),
|
||||||
|
condition: "frightened",
|
||||||
|
value: 2,
|
||||||
|
},
|
||||||
|
]);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("updates the value of an existing condition", () => {
|
||||||
|
const e = enc([makeCombatant("A", [{ id: "frightened", value: 1 }])]);
|
||||||
|
const result = setConditionValue(e, combatantId("A"), "frightened", 3);
|
||||||
|
if (isDomainError(result)) throw new Error(result.message);
|
||||||
|
|
||||||
|
expect(result.encounter.combatants[0].conditions).toEqual([
|
||||||
|
{ id: "frightened", value: 3 },
|
||||||
|
]);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("removes condition when value is 0", () => {
|
||||||
|
const e = enc([makeCombatant("A", [{ id: "frightened", value: 2 }])]);
|
||||||
|
const result = setConditionValue(e, combatantId("A"), "frightened", 0);
|
||||||
|
if (isDomainError(result)) throw new Error(result.message);
|
||||||
|
|
||||||
|
expect(result.encounter.combatants[0].conditions).toBeUndefined();
|
||||||
|
expect(result.events[0].type).toBe("ConditionRemoved");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("rejects unknown condition", () => {
|
||||||
|
const e = enc([makeCombatant("A")]);
|
||||||
|
const result = setConditionValue(
|
||||||
|
e,
|
||||||
|
combatantId("A"),
|
||||||
|
"flying" as ConditionId,
|
||||||
|
1,
|
||||||
|
);
|
||||||
|
expectDomainError(result, "unknown-condition");
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
describe("decrementCondition", () => {
|
||||||
|
it("decrements value by 1", () => {
|
||||||
|
const e = enc([makeCombatant("A", [{ id: "frightened", value: 3 }])]);
|
||||||
|
const result = decrementCondition(e, combatantId("A"), "frightened");
|
||||||
|
if (isDomainError(result)) throw new Error(result.message);
|
||||||
|
|
||||||
|
expect(result.encounter.combatants[0].conditions).toEqual([
|
||||||
|
{ id: "frightened", value: 2 },
|
||||||
|
]);
|
||||||
|
});
|
||||||
|
|
||||||
|
it("removes condition when value reaches 0", () => {
|
||||||
|
const e = enc([makeCombatant("A", [{ id: "frightened", value: 1 }])]);
|
||||||
|
const result = decrementCondition(e, combatantId("A"), "frightened");
|
||||||
|
if (isDomainError(result)) throw new Error(result.message);
|
||||||
|
|
||||||
|
expect(result.encounter.combatants[0].conditions).toBeUndefined();
|
||||||
|
expect(result.events[0].type).toBe("ConditionRemoved");
|
||||||
|
});
|
||||||
|
|
||||||
|
it("removes non-valued condition (value undefined treated as 1)", () => {
|
||||||
|
const e = enc([makeCombatant("A", [{ id: "blinded" }])]);
|
||||||
|
const result = decrementCondition(e, combatantId("A"), "blinded");
|
||||||
|
if (isDomainError(result)) throw new Error(result.message);
|
||||||
|
|
||||||
|
expect(result.encounter.combatants[0].conditions).toBeUndefined();
|
||||||
|
});
|
||||||
|
|
||||||
|
it("returns error for inactive condition", () => {
|
||||||
|
const e = enc([makeCombatant("A")]);
|
||||||
|
const result = decrementCondition(e, combatantId("A"), "frightened");
|
||||||
|
expectDomainError(result, "condition-not-active");
|
||||||
});
|
});
|
||||||
});
|
});
|
||||||
|
|||||||
@@ -1,43 +1,74 @@
|
|||||||
export type ConditionId =
|
export type ConditionId =
|
||||||
| "blinded"
|
| "blinded"
|
||||||
| "charmed"
|
| "charmed"
|
||||||
|
| "clumsy"
|
||||||
|
| "concealed"
|
||||||
|
| "confused"
|
||||||
|
| "controlled"
|
||||||
|
| "dazzled"
|
||||||
| "deafened"
|
| "deafened"
|
||||||
|
| "doomed"
|
||||||
|
| "drained"
|
||||||
|
| "dying"
|
||||||
|
| "enfeebled"
|
||||||
| "exhaustion"
|
| "exhaustion"
|
||||||
|
| "fascinated"
|
||||||
|
| "fatigued"
|
||||||
|
| "fleeing"
|
||||||
| "frightened"
|
| "frightened"
|
||||||
|
| "grabbed"
|
||||||
| "grappled"
|
| "grappled"
|
||||||
|
| "hidden"
|
||||||
|
| "immobilized"
|
||||||
| "incapacitated"
|
| "incapacitated"
|
||||||
| "invisible"
|
| "invisible"
|
||||||
|
| "off-guard"
|
||||||
| "paralyzed"
|
| "paralyzed"
|
||||||
| "petrified"
|
| "petrified"
|
||||||
| "poisoned"
|
| "poisoned"
|
||||||
| "prone"
|
| "prone"
|
||||||
|
| "quickened"
|
||||||
| "restrained"
|
| "restrained"
|
||||||
| "sapped"
|
| "sapped"
|
||||||
|
| "sickened"
|
||||||
| "slowed"
|
| "slowed"
|
||||||
|
| "slowed-pf2e"
|
||||||
| "stunned"
|
| "stunned"
|
||||||
| "unconscious";
|
| "stupefied"
|
||||||
|
| "unconscious"
|
||||||
|
| "undetected"
|
||||||
|
| "wounded";
|
||||||
|
|
||||||
export type RulesEdition = "5e" | "5.5e";
|
export interface ConditionEntry {
|
||||||
|
readonly id: ConditionId;
|
||||||
|
readonly value?: number;
|
||||||
|
}
|
||||||
|
|
||||||
|
import type { RulesEdition } from "./rules-edition.js";
|
||||||
|
|
||||||
export interface ConditionDefinition {
|
export interface ConditionDefinition {
|
||||||
readonly id: ConditionId;
|
readonly id: ConditionId;
|
||||||
readonly label: string;
|
readonly label: string;
|
||||||
readonly description: string;
|
readonly description: string;
|
||||||
readonly description5e: string;
|
readonly description5e: string;
|
||||||
|
readonly descriptionPf2e?: string;
|
||||||
readonly iconName: string;
|
readonly iconName: string;
|
||||||
readonly color: string;
|
readonly color: string;
|
||||||
/** When set, the condition only appears in this edition's picker. */
|
/** When set, the condition only appears in these systems' pickers. */
|
||||||
readonly edition?: RulesEdition;
|
readonly systems?: readonly RulesEdition[];
|
||||||
|
readonly valued?: boolean;
|
||||||
}
|
}
|
||||||
|
|
||||||
export function getConditionDescription(
|
export function getConditionDescription(
|
||||||
def: ConditionDefinition,
|
def: ConditionDefinition,
|
||||||
edition: RulesEdition,
|
edition: RulesEdition,
|
||||||
): string {
|
): string {
|
||||||
|
if (edition === "pf2e" && def.descriptionPf2e) return def.descriptionPf2e;
|
||||||
return edition === "5e" ? def.description5e : def.description;
|
return edition === "5e" ? def.description5e : def.description;
|
||||||
}
|
}
|
||||||
|
|
||||||
export const CONDITION_DEFINITIONS: readonly ConditionDefinition[] = [
|
export const CONDITION_DEFINITIONS: readonly ConditionDefinition[] = [
|
||||||
|
// ── Shared conditions (D&D + PF2e) ──
|
||||||
{
|
{
|
||||||
id: "blinded",
|
id: "blinded",
|
||||||
label: "Blinded",
|
label: "Blinded",
|
||||||
@@ -45,6 +76,8 @@ export const CONDITION_DEFINITIONS: readonly ConditionDefinition[] = [
|
|||||||
"Can't see. Auto-fail sight checks. Attacks have Disadvantage; attacks against have Advantage.",
|
"Can't see. Auto-fail sight checks. Attacks have Disadvantage; attacks against have Advantage.",
|
||||||
description5e:
|
description5e:
|
||||||
"Can't see. Auto-fail sight checks. Attacks have Disadvantage; attacks against have Advantage.",
|
"Can't see. Auto-fail sight checks. Attacks have Disadvantage; attacks against have Advantage.",
|
||||||
|
descriptionPf2e:
|
||||||
|
"Can't see. All terrain is difficult terrain. –4 status penalty to Perception checks involving sight. Immune to visual effects. Auto-fail checks requiring sight. Off-guard.",
|
||||||
iconName: "EyeOff",
|
iconName: "EyeOff",
|
||||||
color: "neutral",
|
color: "neutral",
|
||||||
},
|
},
|
||||||
@@ -57,12 +90,15 @@ export const CONDITION_DEFINITIONS: readonly ConditionDefinition[] = [
|
|||||||
"Can't attack or target the charmer with harmful abilities. Charmer has Advantage on social checks.",
|
"Can't attack or target the charmer with harmful abilities. Charmer has Advantage on social checks.",
|
||||||
iconName: "Heart",
|
iconName: "Heart",
|
||||||
color: "pink",
|
color: "pink",
|
||||||
|
systems: ["5e", "5.5e"],
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
id: "deafened",
|
id: "deafened",
|
||||||
label: "Deafened",
|
label: "Deafened",
|
||||||
description: "Can't hear. Auto-fail hearing checks.",
|
description: "Can't hear. Auto-fail hearing checks.",
|
||||||
description5e: "Can't hear. Auto-fail hearing checks.",
|
description5e: "Can't hear. Auto-fail hearing checks.",
|
||||||
|
descriptionPf2e:
|
||||||
|
"Can't hear. –2 status penalty to Perception checks and Initiative. Auto-fail hearing checks. Immune to auditory effects.",
|
||||||
iconName: "EarOff",
|
iconName: "EarOff",
|
||||||
color: "neutral",
|
color: "neutral",
|
||||||
},
|
},
|
||||||
@@ -75,6 +111,7 @@ export const CONDITION_DEFINITIONS: readonly ConditionDefinition[] = [
|
|||||||
"L1: Disadvantage on ability checks\nL2: Speed halved\nL3: Disadvantage on attacks and saves\nL4: HP max halved\nL5: Speed 0\nL6: Death\nLong rest removes 1 level.",
|
"L1: Disadvantage on ability checks\nL2: Speed halved\nL3: Disadvantage on attacks and saves\nL4: HP max halved\nL5: Speed 0\nL6: Death\nLong rest removes 1 level.",
|
||||||
iconName: "BatteryLow",
|
iconName: "BatteryLow",
|
||||||
color: "amber",
|
color: "amber",
|
||||||
|
systems: ["5e", "5.5e"],
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
id: "frightened",
|
id: "frightened",
|
||||||
@@ -83,8 +120,11 @@ export const CONDITION_DEFINITIONS: readonly ConditionDefinition[] = [
|
|||||||
"Disadvantage on ability checks and attacks while source of fear is in line of sight. Can't willingly move closer to the source.",
|
"Disadvantage on ability checks and attacks while source of fear is in line of sight. Can't willingly move closer to the source.",
|
||||||
description5e:
|
description5e:
|
||||||
"Disadvantage on ability checks and attacks while source of fear is in line of sight. Can't willingly move closer to the source.",
|
"Disadvantage on ability checks and attacks while source of fear is in line of sight. Can't willingly move closer to the source.",
|
||||||
|
descriptionPf2e:
|
||||||
|
"–X status penalty to all checks and DCs (X = value). Can't willingly approach the source.",
|
||||||
iconName: "Siren",
|
iconName: "Siren",
|
||||||
color: "orange",
|
color: "orange",
|
||||||
|
valued: true,
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
id: "grappled",
|
id: "grappled",
|
||||||
@@ -95,6 +135,7 @@ export const CONDITION_DEFINITIONS: readonly ConditionDefinition[] = [
|
|||||||
"Speed 0. Ends if grappler is Incapacitated or moved out of reach.",
|
"Speed 0. Ends if grappler is Incapacitated or moved out of reach.",
|
||||||
iconName: "Hand",
|
iconName: "Hand",
|
||||||
color: "neutral",
|
color: "neutral",
|
||||||
|
systems: ["5e", "5.5e"],
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
id: "incapacitated",
|
id: "incapacitated",
|
||||||
@@ -104,6 +145,7 @@ export const CONDITION_DEFINITIONS: readonly ConditionDefinition[] = [
|
|||||||
description5e: "Can't take Actions or Reactions.",
|
description5e: "Can't take Actions or Reactions.",
|
||||||
iconName: "Ban",
|
iconName: "Ban",
|
||||||
color: "gray",
|
color: "gray",
|
||||||
|
systems: ["5e", "5.5e"],
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
id: "invisible",
|
id: "invisible",
|
||||||
@@ -112,6 +154,8 @@ export const CONDITION_DEFINITIONS: readonly ConditionDefinition[] = [
|
|||||||
"Can't be seen. Advantage on Initiative. Not affected by effects requiring sight (unless caster sees you). Attacks have Advantage; attacks against have Disadvantage.",
|
"Can't be seen. Advantage on Initiative. Not affected by effects requiring sight (unless caster sees you). Attacks have Advantage; attacks against have Disadvantage.",
|
||||||
description5e:
|
description5e:
|
||||||
"Impossible to see without magic or special sense. Heavily Obscured. Attacks have Advantage; attacks against have Disadvantage.",
|
"Impossible to see without magic or special sense. Heavily Obscured. Attacks have Advantage; attacks against have Disadvantage.",
|
||||||
|
descriptionPf2e:
|
||||||
|
"Can't be seen except by special senses. Undetected to everyone. Can't be targeted except by effects that don't require sight.",
|
||||||
iconName: "Ghost",
|
iconName: "Ghost",
|
||||||
color: "violet",
|
color: "violet",
|
||||||
},
|
},
|
||||||
@@ -122,6 +166,7 @@ export const CONDITION_DEFINITIONS: readonly ConditionDefinition[] = [
|
|||||||
"Incapacitated. Can't move or speak. Auto-fail Str/Dex saves. Attacks against have Advantage. Hits within 5 ft. are critical.",
|
"Incapacitated. Can't move or speak. Auto-fail Str/Dex saves. Attacks against have Advantage. Hits within 5 ft. are critical.",
|
||||||
description5e:
|
description5e:
|
||||||
"Incapacitated. Can't move or speak. Auto-fail Str/Dex saves. Attacks against have Advantage. Hits within 5 ft. are critical.",
|
"Incapacitated. Can't move or speak. Auto-fail Str/Dex saves. Attacks against have Advantage. Hits within 5 ft. are critical.",
|
||||||
|
descriptionPf2e: "Can't act. Off-guard. –4 status penalty to AC.",
|
||||||
iconName: "ZapOff",
|
iconName: "ZapOff",
|
||||||
color: "yellow",
|
color: "yellow",
|
||||||
},
|
},
|
||||||
@@ -132,6 +177,8 @@ export const CONDITION_DEFINITIONS: readonly ConditionDefinition[] = [
|
|||||||
"Turned to stone. Weight \u00D710. Incapacitated. Can't move or speak. Attacks against have Advantage. Auto-fail Str/Dex saves. Resistant to all damage. Immune to poison and disease.",
|
"Turned to stone. Weight \u00D710. Incapacitated. Can't move or speak. Attacks against have Advantage. Auto-fail Str/Dex saves. Resistant to all damage. Immune to poison and disease.",
|
||||||
description5e:
|
description5e:
|
||||||
"Turned to stone. Weight \u00D710. Incapacitated. Can't move or speak. Attacks against have Advantage. Auto-fail Str/Dex saves. Resistant to all damage. Immune to poison and disease.",
|
"Turned to stone. Weight \u00D710. Incapacitated. Can't move or speak. Attacks against have Advantage. Auto-fail Str/Dex saves. Resistant to all damage. Immune to poison and disease.",
|
||||||
|
descriptionPf2e:
|
||||||
|
"Can't act. Can't sense anything. AC = 9. Hardness 8. Immune to most effects.",
|
||||||
iconName: "Gem",
|
iconName: "Gem",
|
||||||
color: "slate",
|
color: "slate",
|
||||||
},
|
},
|
||||||
@@ -142,6 +189,7 @@ export const CONDITION_DEFINITIONS: readonly ConditionDefinition[] = [
|
|||||||
description5e: "Disadvantage on attack rolls and ability checks.",
|
description5e: "Disadvantage on attack rolls and ability checks.",
|
||||||
iconName: "Droplet",
|
iconName: "Droplet",
|
||||||
color: "green",
|
color: "green",
|
||||||
|
systems: ["5e", "5.5e"],
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
id: "prone",
|
id: "prone",
|
||||||
@@ -150,6 +198,8 @@ export const CONDITION_DEFINITIONS: readonly ConditionDefinition[] = [
|
|||||||
"Can only crawl (costs extra movement). Disadvantage on attacks. Attacks within 5 ft. have Advantage; ranged attacks have Disadvantage. Standing up costs half movement.",
|
"Can only crawl (costs extra movement). Disadvantage on attacks. Attacks within 5 ft. have Advantage; ranged attacks have Disadvantage. Standing up costs half movement.",
|
||||||
description5e:
|
description5e:
|
||||||
"Can only crawl (costs extra movement). Disadvantage on attacks. Attacks within 5 ft. have Advantage; ranged attacks have Disadvantage. Standing up costs half movement.",
|
"Can only crawl (costs extra movement). Disadvantage on attacks. Attacks within 5 ft. have Advantage; ranged attacks have Disadvantage. Standing up costs half movement.",
|
||||||
|
descriptionPf2e:
|
||||||
|
"Off-guard. –2 circumstance penalty to attack rolls. Only movement is Crawl and Stand. +1 circumstance bonus to AC vs. ranged attacks, –2 vs. melee.",
|
||||||
iconName: "ArrowDown",
|
iconName: "ArrowDown",
|
||||||
color: "neutral",
|
color: "neutral",
|
||||||
},
|
},
|
||||||
@@ -160,6 +210,8 @@ export const CONDITION_DEFINITIONS: readonly ConditionDefinition[] = [
|
|||||||
"Speed is 0. Attacks have Disadvantage. Attacks against have Advantage. Disadvantage on Dex saves.",
|
"Speed is 0. Attacks have Disadvantage. Attacks against have Advantage. Disadvantage on Dex saves.",
|
||||||
description5e:
|
description5e:
|
||||||
"Speed is 0. Attacks have Disadvantage. Attacks against have Advantage. Disadvantage on Dex saves.",
|
"Speed is 0. Attacks have Disadvantage. Attacks against have Advantage. Disadvantage on Dex saves.",
|
||||||
|
descriptionPf2e:
|
||||||
|
"Off-guard. Immobilized. Can't use any actions with the attack trait except to attempt to Escape.",
|
||||||
iconName: "Link",
|
iconName: "Link",
|
||||||
color: "neutral",
|
color: "neutral",
|
||||||
},
|
},
|
||||||
@@ -171,7 +223,7 @@ export const CONDITION_DEFINITIONS: readonly ConditionDefinition[] = [
|
|||||||
description5e: "",
|
description5e: "",
|
||||||
iconName: "ShieldMinus",
|
iconName: "ShieldMinus",
|
||||||
color: "amber",
|
color: "amber",
|
||||||
edition: "5.5e",
|
systems: ["5.5e"],
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
id: "slowed",
|
id: "slowed",
|
||||||
@@ -181,7 +233,7 @@ export const CONDITION_DEFINITIONS: readonly ConditionDefinition[] = [
|
|||||||
description5e: "",
|
description5e: "",
|
||||||
iconName: "Snail",
|
iconName: "Snail",
|
||||||
color: "sky",
|
color: "sky",
|
||||||
edition: "5.5e",
|
systems: ["5.5e"],
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
id: "stunned",
|
id: "stunned",
|
||||||
@@ -190,8 +242,11 @@ export const CONDITION_DEFINITIONS: readonly ConditionDefinition[] = [
|
|||||||
"Incapacitated (can't act or speak). Auto-fail Str/Dex saves. Attacks against have Advantage.",
|
"Incapacitated (can't act or speak). Auto-fail Str/Dex saves. Attacks against have Advantage.",
|
||||||
description5e:
|
description5e:
|
||||||
"Incapacitated. Can't move. Can speak only falteringly. Auto-fail Str/Dex saves. Attacks against have Advantage.",
|
"Incapacitated. Can't move. Can speak only falteringly. Auto-fail Str/Dex saves. Attacks against have Advantage.",
|
||||||
|
descriptionPf2e:
|
||||||
|
"Can't act. –X value to actions per turn while the value counts down.",
|
||||||
iconName: "Sparkles",
|
iconName: "Sparkles",
|
||||||
color: "yellow",
|
color: "yellow",
|
||||||
|
valued: true,
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
id: "unconscious",
|
id: "unconscious",
|
||||||
@@ -200,9 +255,261 @@ export const CONDITION_DEFINITIONS: readonly ConditionDefinition[] = [
|
|||||||
"Incapacitated. Speed 0. Can't move or speak. Unaware of surroundings. Drops held items, falls Prone. Auto-fail Str/Dex saves. Attacks against have Advantage. Hits within 5 ft. are critical.",
|
"Incapacitated. Speed 0. Can't move or speak. Unaware of surroundings. Drops held items, falls Prone. Auto-fail Str/Dex saves. Attacks against have Advantage. Hits within 5 ft. are critical.",
|
||||||
description5e:
|
description5e:
|
||||||
"Incapacitated. Speed 0. Can't move or speak. Unaware of surroundings. Drops held items, falls Prone. Auto-fail Str/Dex saves. Attacks against have Advantage. Hits within 5 ft. are critical.",
|
"Incapacitated. Speed 0. Can't move or speak. Unaware of surroundings. Drops held items, falls Prone. Auto-fail Str/Dex saves. Attacks against have Advantage. Hits within 5 ft. are critical.",
|
||||||
|
descriptionPf2e:
|
||||||
|
"Can't act. Off-guard. –4 status penalty to AC. –3 to Perception. Fall prone, drop items.",
|
||||||
iconName: "Moon",
|
iconName: "Moon",
|
||||||
color: "indigo",
|
color: "indigo",
|
||||||
},
|
},
|
||||||
|
// ── PF2e-only conditions ──
|
||||||
|
{
|
||||||
|
id: "clumsy",
|
||||||
|
label: "Clumsy",
|
||||||
|
description: "",
|
||||||
|
description5e: "",
|
||||||
|
descriptionPf2e:
|
||||||
|
"–X status penalty to Dex-based checks and DCs, including AC, Reflex saves, and ranged attack rolls.",
|
||||||
|
iconName: "Footprints",
|
||||||
|
color: "amber",
|
||||||
|
systems: ["pf2e"],
|
||||||
|
valued: true,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: "concealed",
|
||||||
|
label: "Concealed",
|
||||||
|
description: "",
|
||||||
|
description5e: "",
|
||||||
|
descriptionPf2e:
|
||||||
|
"DC 5 flat check for targeted attacks. Doesn't change which creatures can see you.",
|
||||||
|
iconName: "CloudFog",
|
||||||
|
color: "slate",
|
||||||
|
systems: ["pf2e"],
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: "confused",
|
||||||
|
label: "Confused",
|
||||||
|
description: "",
|
||||||
|
description5e: "",
|
||||||
|
descriptionPf2e:
|
||||||
|
"Off-guard. Can't Delay, Ready, or use reactions. GM determines targets randomly. Flat check DC 11 to act normally each turn.",
|
||||||
|
iconName: "CircleHelp",
|
||||||
|
color: "pink",
|
||||||
|
systems: ["pf2e"],
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: "controlled",
|
||||||
|
label: "Controlled",
|
||||||
|
description: "",
|
||||||
|
description5e: "",
|
||||||
|
descriptionPf2e:
|
||||||
|
"Another creature determines your actions. You gain no actions of your own.",
|
||||||
|
iconName: "Drama",
|
||||||
|
color: "pink",
|
||||||
|
systems: ["pf2e"],
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: "dazzled",
|
||||||
|
label: "Dazzled",
|
||||||
|
description: "",
|
||||||
|
description5e: "",
|
||||||
|
descriptionPf2e:
|
||||||
|
"All creatures and objects are concealed to you. DC 5 flat check for targeted attacks requiring sight.",
|
||||||
|
iconName: "Sun",
|
||||||
|
color: "yellow",
|
||||||
|
systems: ["pf2e"],
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: "doomed",
|
||||||
|
label: "Doomed",
|
||||||
|
description: "",
|
||||||
|
description5e: "",
|
||||||
|
descriptionPf2e:
|
||||||
|
"Die at dying X (where X = 4 – doomed value instead of dying 4). Decreases by 1 on full night's rest.",
|
||||||
|
iconName: "Skull",
|
||||||
|
color: "red",
|
||||||
|
systems: ["pf2e"],
|
||||||
|
valued: true,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: "drained",
|
||||||
|
label: "Drained",
|
||||||
|
description: "",
|
||||||
|
description5e: "",
|
||||||
|
descriptionPf2e:
|
||||||
|
"–X status penalty to Con-based checks and DCs. Lose X × Hit Die in max HP. Decreases by 1 on full night's rest.",
|
||||||
|
iconName: "Droplets",
|
||||||
|
color: "red",
|
||||||
|
systems: ["pf2e"],
|
||||||
|
valued: true,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: "dying",
|
||||||
|
label: "Dying",
|
||||||
|
description: "",
|
||||||
|
description5e: "",
|
||||||
|
descriptionPf2e:
|
||||||
|
"Unconscious. Make recovery checks at start of turn. At dying 4 (or 4 – doomed), you die.",
|
||||||
|
iconName: "HeartPulse",
|
||||||
|
color: "red",
|
||||||
|
systems: ["pf2e"],
|
||||||
|
valued: true,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: "enfeebled",
|
||||||
|
label: "Enfeebled",
|
||||||
|
description: "",
|
||||||
|
description5e: "",
|
||||||
|
descriptionPf2e:
|
||||||
|
"–X status penalty to Str-based rolls, including melee attack and damage rolls.",
|
||||||
|
iconName: "TrendingDown",
|
||||||
|
color: "amber",
|
||||||
|
systems: ["pf2e"],
|
||||||
|
valued: true,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: "fascinated",
|
||||||
|
label: "Fascinated",
|
||||||
|
description: "",
|
||||||
|
description5e: "",
|
||||||
|
descriptionPf2e:
|
||||||
|
"–2 status penalty to all checks. Can't use hostile actions. Ends if hostile action is used against you.",
|
||||||
|
iconName: "Eye",
|
||||||
|
color: "violet",
|
||||||
|
systems: ["pf2e"],
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: "fatigued",
|
||||||
|
label: "Fatigued",
|
||||||
|
description: "",
|
||||||
|
description5e: "",
|
||||||
|
descriptionPf2e:
|
||||||
|
"–1 status penalty to AC and saves. Can't use exploration activities while traveling. Recover after a full night's rest.",
|
||||||
|
iconName: "BatteryLow",
|
||||||
|
color: "amber",
|
||||||
|
systems: ["pf2e"],
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: "fleeing",
|
||||||
|
label: "Fleeing",
|
||||||
|
description: "",
|
||||||
|
description5e: "",
|
||||||
|
descriptionPf2e:
|
||||||
|
"Must spend actions to move away from the source. Can't Delay or Ready.",
|
||||||
|
iconName: "PersonStanding",
|
||||||
|
color: "orange",
|
||||||
|
systems: ["pf2e"],
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: "grabbed",
|
||||||
|
label: "Grabbed",
|
||||||
|
description: "",
|
||||||
|
description5e: "",
|
||||||
|
descriptionPf2e:
|
||||||
|
"Immobilized. Off-guard. Can't use actions with the move trait unless to Break Grapple.",
|
||||||
|
iconName: "Hand",
|
||||||
|
color: "neutral",
|
||||||
|
systems: ["pf2e"],
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: "hidden",
|
||||||
|
label: "Hidden",
|
||||||
|
description: "",
|
||||||
|
description5e: "",
|
||||||
|
descriptionPf2e:
|
||||||
|
"Known location but can't be seen. DC 11 flat check to target. Can use Seek to find.",
|
||||||
|
iconName: "EyeOff",
|
||||||
|
color: "slate",
|
||||||
|
systems: ["pf2e"],
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: "immobilized",
|
||||||
|
label: "Immobilized",
|
||||||
|
description: "",
|
||||||
|
description5e: "",
|
||||||
|
descriptionPf2e:
|
||||||
|
"Can't use any action with the move trait to change position.",
|
||||||
|
iconName: "Anchor",
|
||||||
|
color: "neutral",
|
||||||
|
systems: ["pf2e"],
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: "off-guard",
|
||||||
|
label: "Off-Guard",
|
||||||
|
description: "",
|
||||||
|
description5e: "",
|
||||||
|
descriptionPf2e: "–2 circumstance penalty to AC. (Formerly flat-footed.)",
|
||||||
|
iconName: "ShieldOff",
|
||||||
|
color: "amber",
|
||||||
|
systems: ["pf2e"],
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: "quickened",
|
||||||
|
label: "Quickened",
|
||||||
|
description: "",
|
||||||
|
description5e: "",
|
||||||
|
descriptionPf2e:
|
||||||
|
"Gain 1 extra action at the start of your turn each round (limited uses specified by the effect).",
|
||||||
|
iconName: "Zap",
|
||||||
|
color: "green",
|
||||||
|
systems: ["pf2e"],
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: "sickened",
|
||||||
|
label: "Sickened",
|
||||||
|
description: "",
|
||||||
|
description5e: "",
|
||||||
|
descriptionPf2e:
|
||||||
|
"–X status penalty to all checks and DCs. Can't willingly ingest anything. Reduce by retching (Fortitude save).",
|
||||||
|
iconName: "Droplet",
|
||||||
|
color: "green",
|
||||||
|
systems: ["pf2e"],
|
||||||
|
valued: true,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: "slowed-pf2e",
|
||||||
|
label: "Slowed",
|
||||||
|
description: "",
|
||||||
|
description5e: "",
|
||||||
|
descriptionPf2e: "Lose X actions at the start of your turn each round.",
|
||||||
|
iconName: "Snail",
|
||||||
|
color: "sky",
|
||||||
|
systems: ["pf2e"],
|
||||||
|
valued: true,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: "stupefied",
|
||||||
|
label: "Stupefied",
|
||||||
|
description: "",
|
||||||
|
description5e: "",
|
||||||
|
descriptionPf2e:
|
||||||
|
"–X status penalty to Int/Wis/Cha-based checks and DCs, including spell attack rolls and spell DCs. DC 5 + X flat check to cast spells or lose the spell.",
|
||||||
|
iconName: "BrainCog",
|
||||||
|
color: "violet",
|
||||||
|
systems: ["pf2e"],
|
||||||
|
valued: true,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: "undetected",
|
||||||
|
label: "Undetected",
|
||||||
|
description: "",
|
||||||
|
description5e: "",
|
||||||
|
descriptionPf2e:
|
||||||
|
"Location unknown. Must pick a square to target; DC 11 flat check. Attacker is off-guard against your attacks.",
|
||||||
|
iconName: "Ghost",
|
||||||
|
color: "violet",
|
||||||
|
systems: ["pf2e"],
|
||||||
|
},
|
||||||
|
{
|
||||||
|
id: "wounded",
|
||||||
|
label: "Wounded",
|
||||||
|
description: "",
|
||||||
|
description5e: "",
|
||||||
|
descriptionPf2e:
|
||||||
|
"Next time you gain dying, add wounded value to dying value. Wounded 1 when you recover from dying; increases if already wounded.",
|
||||||
|
iconName: "HeartCrack",
|
||||||
|
color: "red",
|
||||||
|
systems: ["pf2e"],
|
||||||
|
valued: true,
|
||||||
|
},
|
||||||
] as const;
|
] as const;
|
||||||
|
|
||||||
export const VALID_CONDITION_IDS: ReadonlySet<string> = new Set(
|
export const VALID_CONDITION_IDS: ReadonlySet<string> = new Set(
|
||||||
@@ -213,6 +520,6 @@ export function getConditionsForEdition(
|
|||||||
edition: RulesEdition,
|
edition: RulesEdition,
|
||||||
): readonly ConditionDefinition[] {
|
): readonly ConditionDefinition[] {
|
||||||
return CONDITION_DEFINITIONS.filter(
|
return CONDITION_DEFINITIONS.filter(
|
||||||
(d) => d.edition === undefined || d.edition === edition,
|
(d) => d.systems === undefined || d.systems.includes(edition),
|
||||||
);
|
);
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -5,9 +5,18 @@ export function creatureId(id: string): CreatureId {
|
|||||||
return id as CreatureId;
|
return id as CreatureId;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
export type TraitSegment =
|
||||||
|
| { readonly type: "text"; readonly value: string }
|
||||||
|
| { readonly type: "list"; readonly items: readonly TraitListItem[] };
|
||||||
|
|
||||||
|
export interface TraitListItem {
|
||||||
|
readonly label?: string;
|
||||||
|
readonly text: string;
|
||||||
|
}
|
||||||
|
|
||||||
export interface TraitBlock {
|
export interface TraitBlock {
|
||||||
readonly name: string;
|
readonly name: string;
|
||||||
readonly text: string;
|
readonly segments: readonly TraitSegment[];
|
||||||
}
|
}
|
||||||
|
|
||||||
export interface LegendaryBlock {
|
export interface LegendaryBlock {
|
||||||
@@ -92,6 +101,62 @@ export interface BestiaryIndex {
|
|||||||
readonly creatures: readonly BestiaryIndexEntry[];
|
readonly creatures: readonly BestiaryIndexEntry[];
|
||||||
}
|
}
|
||||||
|
|
||||||
|
export interface Pf2eCreature {
|
||||||
|
readonly system: "pf2e";
|
||||||
|
readonly id: CreatureId;
|
||||||
|
readonly name: string;
|
||||||
|
readonly source: string;
|
||||||
|
readonly sourceDisplayName: string;
|
||||||
|
readonly level: number;
|
||||||
|
readonly traits: readonly string[];
|
||||||
|
readonly perception: number;
|
||||||
|
readonly senses?: string;
|
||||||
|
readonly languages?: string;
|
||||||
|
readonly skills?: string;
|
||||||
|
readonly abilityMods: {
|
||||||
|
readonly str: number;
|
||||||
|
readonly dex: number;
|
||||||
|
readonly con: number;
|
||||||
|
readonly int: number;
|
||||||
|
readonly wis: number;
|
||||||
|
readonly cha: number;
|
||||||
|
};
|
||||||
|
readonly items?: string;
|
||||||
|
readonly ac: number;
|
||||||
|
readonly acConditional?: string;
|
||||||
|
readonly saveFort: number;
|
||||||
|
readonly saveRef: number;
|
||||||
|
readonly saveWill: number;
|
||||||
|
readonly hp: number;
|
||||||
|
readonly immunities?: string;
|
||||||
|
readonly resistances?: string;
|
||||||
|
readonly weaknesses?: string;
|
||||||
|
readonly speed: string;
|
||||||
|
readonly attacks?: readonly TraitBlock[];
|
||||||
|
readonly abilitiesTop?: readonly TraitBlock[];
|
||||||
|
readonly abilitiesMid?: readonly TraitBlock[];
|
||||||
|
readonly abilitiesBot?: readonly TraitBlock[];
|
||||||
|
readonly spellcasting?: readonly SpellcastingBlock[];
|
||||||
|
}
|
||||||
|
|
||||||
|
export type AnyCreature = Creature | Pf2eCreature;
|
||||||
|
|
||||||
|
export interface Pf2eBestiaryIndexEntry {
|
||||||
|
readonly name: string;
|
||||||
|
readonly source: string;
|
||||||
|
readonly level: number;
|
||||||
|
readonly ac: number;
|
||||||
|
readonly hp: number;
|
||||||
|
readonly perception: number;
|
||||||
|
readonly size: string;
|
||||||
|
readonly type: string;
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface Pf2eBestiaryIndex {
|
||||||
|
readonly sources: Readonly<Record<string, string>>;
|
||||||
|
readonly creatures: readonly Pf2eBestiaryIndexEntry[];
|
||||||
|
}
|
||||||
|
|
||||||
/** Maps a CR string to the corresponding proficiency bonus. */
|
/** Maps a CR string to the corresponding proficiency bonus. */
|
||||||
export function proficiencyBonus(cr: string): number {
|
export function proficiencyBonus(cr: string): number {
|
||||||
const numericCr = cr.includes("/")
|
const numericCr = cr.includes("/")
|
||||||
|
|||||||
@@ -1,13 +1,23 @@
|
|||||||
export type DifficultyTier = "trivial" | "low" | "moderate" | "high";
|
import type { RulesEdition } from "./rules-edition.js";
|
||||||
|
|
||||||
|
/** Abstract difficulty severity: 0 = negligible, 3 = maximum. Maps to filled bar count. */
|
||||||
|
export type DifficultyTier = 0 | 1 | 2 | 3;
|
||||||
|
|
||||||
|
export interface DifficultyThreshold {
|
||||||
|
readonly label: string;
|
||||||
|
readonly value: number;
|
||||||
|
}
|
||||||
|
|
||||||
export interface DifficultyResult {
|
export interface DifficultyResult {
|
||||||
readonly tier: DifficultyTier;
|
readonly tier: DifficultyTier;
|
||||||
readonly totalMonsterXp: number;
|
readonly totalMonsterXp: number;
|
||||||
readonly partyBudget: {
|
readonly thresholds: readonly DifficultyThreshold[];
|
||||||
readonly low: number;
|
/** 2014 only: the encounter multiplier applied to base monster XP. */
|
||||||
readonly moderate: number;
|
readonly encounterMultiplier: number | undefined;
|
||||||
readonly high: number;
|
/** 2014 only: monster XP after applying the encounter multiplier. */
|
||||||
};
|
readonly adjustedXp: number | undefined;
|
||||||
|
/** 2014 only: true when the multiplier was shifted due to party size (<3 or 6+). */
|
||||||
|
readonly partySizeAdjusted: boolean | undefined;
|
||||||
}
|
}
|
||||||
|
|
||||||
/** Maps challenge rating strings to XP values (standard 5e). */
|
/** Maps challenge rating strings to XP values (standard 5e). */
|
||||||
@@ -74,6 +84,82 @@ const XP_BUDGET_PER_CHARACTER: Readonly<
|
|||||||
20: { low: 6400, moderate: 13200, high: 22000 },
|
20: { low: 6400, moderate: 13200, high: 22000 },
|
||||||
};
|
};
|
||||||
|
|
||||||
|
/** Maps character level (1-20) to XP thresholds (2014 DMG). */
|
||||||
|
const XP_THRESHOLDS_2014: Readonly<
|
||||||
|
Record<number, { easy: number; medium: number; hard: number; deadly: number }>
|
||||||
|
> = {
|
||||||
|
1: { easy: 25, medium: 50, hard: 75, deadly: 100 },
|
||||||
|
2: { easy: 50, medium: 100, hard: 150, deadly: 200 },
|
||||||
|
3: { easy: 75, medium: 150, hard: 225, deadly: 400 },
|
||||||
|
4: { easy: 125, medium: 250, hard: 375, deadly: 500 },
|
||||||
|
5: { easy: 250, medium: 500, hard: 750, deadly: 1100 },
|
||||||
|
6: { easy: 300, medium: 600, hard: 900, deadly: 1400 },
|
||||||
|
7: { easy: 350, medium: 750, hard: 1100, deadly: 1700 },
|
||||||
|
8: { easy: 450, medium: 900, hard: 1400, deadly: 2100 },
|
||||||
|
9: { easy: 550, medium: 1100, hard: 1600, deadly: 2400 },
|
||||||
|
10: { easy: 600, medium: 1200, hard: 1900, deadly: 2800 },
|
||||||
|
11: { easy: 800, medium: 1600, hard: 2400, deadly: 3600 },
|
||||||
|
12: { easy: 1000, medium: 2000, hard: 3000, deadly: 4500 },
|
||||||
|
13: { easy: 1100, medium: 2200, hard: 3400, deadly: 5100 },
|
||||||
|
14: { easy: 1250, medium: 2500, hard: 3800, deadly: 5700 },
|
||||||
|
15: { easy: 1400, medium: 2800, hard: 4300, deadly: 6400 },
|
||||||
|
16: { easy: 1600, medium: 3200, hard: 4800, deadly: 7200 },
|
||||||
|
17: { easy: 2000, medium: 3900, hard: 5900, deadly: 8800 },
|
||||||
|
18: { easy: 2100, medium: 4200, hard: 6300, deadly: 9500 },
|
||||||
|
19: { easy: 2400, medium: 4900, hard: 7300, deadly: 10900 },
|
||||||
|
20: { easy: 2800, medium: 5700, hard: 8500, deadly: 12700 },
|
||||||
|
};
|
||||||
|
|
||||||
|
/** 2014 encounter multiplier by number of enemy-side monsters. */
|
||||||
|
const ENCOUNTER_MULTIPLIER_TABLE: readonly {
|
||||||
|
max: number;
|
||||||
|
multiplier: number;
|
||||||
|
}[] = [
|
||||||
|
{ max: 1, multiplier: 1 },
|
||||||
|
{ max: 2, multiplier: 1.5 },
|
||||||
|
{ max: 6, multiplier: 2 },
|
||||||
|
{ max: 10, multiplier: 2.5 },
|
||||||
|
{ max: 14, multiplier: 3 },
|
||||||
|
{ max: Number.POSITIVE_INFINITY, multiplier: 4 },
|
||||||
|
];
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Multiplier values in ascending order for party size shifting.
|
||||||
|
* Extends beyond the base table: x0.5 (6+ PCs, 1 monster) and x5 (<3 PCs, 15+ monsters)
|
||||||
|
* per 2014 DMG party size adjustment rules.
|
||||||
|
*/
|
||||||
|
const MULTIPLIER_STEPS = [0.5, 1, 1.5, 2, 2.5, 3, 4, 5] as const;
|
||||||
|
|
||||||
|
/** Index into MULTIPLIER_STEPS for each base table entry (before party size adjustment). */
|
||||||
|
const BASE_STEP_INDEX = [1, 2, 3, 4, 5, 6] as const;
|
||||||
|
|
||||||
|
function getEncounterMultiplier(
|
||||||
|
monsterCount: number,
|
||||||
|
partySize: number,
|
||||||
|
): { multiplier: number; partySizeAdjusted: boolean } {
|
||||||
|
const tableIndex = ENCOUNTER_MULTIPLIER_TABLE.findIndex(
|
||||||
|
(entry) => monsterCount <= entry.max,
|
||||||
|
);
|
||||||
|
let stepIndex: number =
|
||||||
|
BASE_STEP_INDEX[
|
||||||
|
tableIndex === -1 ? BASE_STEP_INDEX.length - 1 : tableIndex
|
||||||
|
];
|
||||||
|
let partySizeAdjusted = false;
|
||||||
|
|
||||||
|
if (partySize < 3) {
|
||||||
|
stepIndex = Math.min(stepIndex + 1, MULTIPLIER_STEPS.length - 1);
|
||||||
|
partySizeAdjusted = true;
|
||||||
|
} else if (partySize >= 6) {
|
||||||
|
stepIndex = Math.max(stepIndex - 1, 0);
|
||||||
|
partySizeAdjusted = true;
|
||||||
|
}
|
||||||
|
|
||||||
|
return {
|
||||||
|
multiplier: MULTIPLIER_STEPS[stepIndex] as number,
|
||||||
|
partySizeAdjusted,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
/** All standard 5e challenge rating strings, in ascending order. */
|
/** All standard 5e challenge rating strings, in ascending order. */
|
||||||
export const VALID_CR_VALUES: readonly string[] = Object.keys(CR_TO_XP);
|
export const VALID_CR_VALUES: readonly string[] = Object.keys(CR_TO_XP);
|
||||||
|
|
||||||
@@ -82,48 +168,131 @@ export function crToXp(cr: string): number {
|
|||||||
return CR_TO_XP[cr] ?? 0;
|
return CR_TO_XP[cr] ?? 0;
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
export interface CombatantDescriptor {
|
||||||
* Calculates encounter difficulty from party levels and monster CRs.
|
readonly level?: number;
|
||||||
* Both arrays should be pre-filtered (only PCs with levels, only bestiary-linked monsters).
|
readonly cr?: string;
|
||||||
*/
|
readonly side: "party" | "enemy";
|
||||||
export function calculateEncounterDifficulty(
|
}
|
||||||
partyLevels: readonly number[],
|
|
||||||
monsterCrs: readonly string[],
|
|
||||||
): DifficultyResult {
|
|
||||||
let budgetLow = 0;
|
|
||||||
let budgetModerate = 0;
|
|
||||||
let budgetHigh = 0;
|
|
||||||
|
|
||||||
for (const level of partyLevels) {
|
function determineTier(
|
||||||
const budget = XP_BUDGET_PER_CHARACTER[level];
|
xp: number,
|
||||||
if (budget) {
|
tierThresholds: readonly number[],
|
||||||
budgetLow += budget.low;
|
): DifficultyTier {
|
||||||
budgetModerate += budget.moderate;
|
for (let i = tierThresholds.length - 1; i >= 0; i--) {
|
||||||
budgetHigh += budget.high;
|
if (xp >= tierThresholds[i]) return (i + 1) as DifficultyTier;
|
||||||
|
}
|
||||||
|
return 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
function accumulateBudget5_5e(levels: readonly number[]) {
|
||||||
|
const budget = { low: 0, moderate: 0, high: 0 };
|
||||||
|
for (const level of levels) {
|
||||||
|
const b = XP_BUDGET_PER_CHARACTER[level];
|
||||||
|
if (b) {
|
||||||
|
budget.low += b.low;
|
||||||
|
budget.moderate += b.moderate;
|
||||||
|
budget.high += b.high;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
return budget;
|
||||||
|
}
|
||||||
|
|
||||||
|
function accumulateBudget2014(levels: readonly number[]) {
|
||||||
|
const budget = { easy: 0, medium: 0, hard: 0, deadly: 0 };
|
||||||
|
for (const level of levels) {
|
||||||
|
const b = XP_THRESHOLDS_2014[level];
|
||||||
|
if (b) {
|
||||||
|
budget.easy += b.easy;
|
||||||
|
budget.medium += b.medium;
|
||||||
|
budget.hard += b.hard;
|
||||||
|
budget.deadly += b.deadly;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return budget;
|
||||||
|
}
|
||||||
|
|
||||||
|
function scanCombatants(combatants: readonly CombatantDescriptor[]) {
|
||||||
let totalMonsterXp = 0;
|
let totalMonsterXp = 0;
|
||||||
for (const cr of monsterCrs) {
|
let monsterCount = 0;
|
||||||
totalMonsterXp += crToXp(cr);
|
const partyLevels: number[] = [];
|
||||||
}
|
|
||||||
|
|
||||||
let tier: DifficultyTier = "trivial";
|
for (const c of combatants) {
|
||||||
if (totalMonsterXp >= budgetHigh) {
|
if (c.level !== undefined && c.side === "party") {
|
||||||
tier = "high";
|
partyLevels.push(c.level);
|
||||||
} else if (totalMonsterXp >= budgetModerate) {
|
}
|
||||||
tier = "moderate";
|
if (c.cr !== undefined) {
|
||||||
} else if (totalMonsterXp >= budgetLow) {
|
const xp = crToXp(c.cr);
|
||||||
tier = "low";
|
if (c.side === "enemy") {
|
||||||
|
totalMonsterXp += xp;
|
||||||
|
monsterCount++;
|
||||||
|
} else {
|
||||||
|
totalMonsterXp -= xp;
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
return {
|
return {
|
||||||
tier,
|
totalMonsterXp: Math.max(0, totalMonsterXp),
|
||||||
totalMonsterXp,
|
monsterCount,
|
||||||
partyBudget: {
|
partyLevels,
|
||||||
low: budgetLow,
|
};
|
||||||
moderate: budgetModerate,
|
}
|
||||||
high: budgetHigh,
|
|
||||||
},
|
/**
|
||||||
|
* Calculates encounter difficulty from combatant descriptors.
|
||||||
|
* Party-side combatants with level contribute to the budget.
|
||||||
|
* Enemy-side combatants with CR add XP; party-side with CR subtract XP (floored at 0).
|
||||||
|
*/
|
||||||
|
export function calculateEncounterDifficulty(
|
||||||
|
combatants: readonly CombatantDescriptor[],
|
||||||
|
edition: RulesEdition,
|
||||||
|
): DifficultyResult {
|
||||||
|
const { totalMonsterXp, monsterCount, partyLevels } =
|
||||||
|
scanCombatants(combatants);
|
||||||
|
|
||||||
|
if (edition === "5.5e") {
|
||||||
|
const budget = accumulateBudget5_5e(partyLevels);
|
||||||
|
const thresholds: DifficultyThreshold[] = [
|
||||||
|
{ label: "Low", value: budget.low },
|
||||||
|
{ label: "Moderate", value: budget.moderate },
|
||||||
|
{ label: "High", value: budget.high },
|
||||||
|
];
|
||||||
|
return {
|
||||||
|
tier: determineTier(totalMonsterXp, [
|
||||||
|
budget.low,
|
||||||
|
budget.moderate,
|
||||||
|
budget.high,
|
||||||
|
]),
|
||||||
|
totalMonsterXp,
|
||||||
|
thresholds,
|
||||||
|
encounterMultiplier: undefined,
|
||||||
|
adjustedXp: undefined,
|
||||||
|
partySizeAdjusted: undefined,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
// 2014 edition
|
||||||
|
const budget = accumulateBudget2014(partyLevels);
|
||||||
|
const { multiplier: encounterMultiplier, partySizeAdjusted } =
|
||||||
|
getEncounterMultiplier(monsterCount, partyLevels.length);
|
||||||
|
const adjustedXp = Math.round(totalMonsterXp * encounterMultiplier);
|
||||||
|
const thresholds: DifficultyThreshold[] = [
|
||||||
|
{ label: "Easy", value: budget.easy },
|
||||||
|
{ label: "Medium", value: budget.medium },
|
||||||
|
{ label: "Hard", value: budget.hard },
|
||||||
|
{ label: "Deadly", value: budget.deadly },
|
||||||
|
];
|
||||||
|
|
||||||
|
return {
|
||||||
|
tier: determineTier(adjustedXp, [
|
||||||
|
budget.medium,
|
||||||
|
budget.hard,
|
||||||
|
budget.deadly,
|
||||||
|
]),
|
||||||
|
totalMonsterXp,
|
||||||
|
thresholds,
|
||||||
|
encounterMultiplier,
|
||||||
|
adjustedXp,
|
||||||
|
partySizeAdjusted,
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -101,16 +101,25 @@ export interface CrSet {
|
|||||||
readonly newCr: string | undefined;
|
readonly newCr: string | undefined;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
export interface SideSet {
|
||||||
|
readonly type: "SideSet";
|
||||||
|
readonly combatantId: CombatantId;
|
||||||
|
readonly previousSide: "party" | "enemy" | undefined;
|
||||||
|
readonly newSide: "party" | "enemy";
|
||||||
|
}
|
||||||
|
|
||||||
export interface ConditionAdded {
|
export interface ConditionAdded {
|
||||||
readonly type: "ConditionAdded";
|
readonly type: "ConditionAdded";
|
||||||
readonly combatantId: CombatantId;
|
readonly combatantId: CombatantId;
|
||||||
readonly condition: ConditionId;
|
readonly condition: ConditionId;
|
||||||
|
readonly value?: number;
|
||||||
}
|
}
|
||||||
|
|
||||||
export interface ConditionRemoved {
|
export interface ConditionRemoved {
|
||||||
readonly type: "ConditionRemoved";
|
readonly type: "ConditionRemoved";
|
||||||
readonly combatantId: CombatantId;
|
readonly combatantId: CombatantId;
|
||||||
readonly condition: ConditionId;
|
readonly condition: ConditionId;
|
||||||
|
readonly value?: number;
|
||||||
}
|
}
|
||||||
|
|
||||||
export interface ConcentrationStarted {
|
export interface ConcentrationStarted {
|
||||||
@@ -161,6 +170,7 @@ export type DomainEvent =
|
|||||||
| RoundRetreated
|
| RoundRetreated
|
||||||
| AcSet
|
| AcSet
|
||||||
| CrSet
|
| CrSet
|
||||||
|
| SideSet
|
||||||
| ConditionAdded
|
| ConditionAdded
|
||||||
| ConditionRemoved
|
| ConditionRemoved
|
||||||
| ConcentrationStarted
|
| ConcentrationStarted
|
||||||
|
|||||||
@@ -13,10 +13,10 @@ export {
|
|||||||
export {
|
export {
|
||||||
CONDITION_DEFINITIONS,
|
CONDITION_DEFINITIONS,
|
||||||
type ConditionDefinition,
|
type ConditionDefinition,
|
||||||
|
type ConditionEntry,
|
||||||
type ConditionId,
|
type ConditionId,
|
||||||
getConditionDescription,
|
getConditionDescription,
|
||||||
getConditionsForEdition,
|
getConditionsForEdition,
|
||||||
type RulesEdition,
|
|
||||||
VALID_CONDITION_IDS,
|
VALID_CONDITION_IDS,
|
||||||
} from "./conditions.js";
|
} from "./conditions.js";
|
||||||
export {
|
export {
|
||||||
@@ -24,6 +24,7 @@ export {
|
|||||||
createPlayerCharacter,
|
createPlayerCharacter,
|
||||||
} from "./create-player-character.js";
|
} from "./create-player-character.js";
|
||||||
export {
|
export {
|
||||||
|
type AnyCreature,
|
||||||
type BestiaryIndex,
|
type BestiaryIndex,
|
||||||
type BestiaryIndexEntry,
|
type BestiaryIndexEntry,
|
||||||
type BestiarySource,
|
type BestiarySource,
|
||||||
@@ -32,9 +33,14 @@ export {
|
|||||||
creatureId,
|
creatureId,
|
||||||
type DailySpells,
|
type DailySpells,
|
||||||
type LegendaryBlock,
|
type LegendaryBlock,
|
||||||
|
type Pf2eBestiaryIndex,
|
||||||
|
type Pf2eBestiaryIndexEntry,
|
||||||
|
type Pf2eCreature,
|
||||||
proficiencyBonus,
|
proficiencyBonus,
|
||||||
type SpellcastingBlock,
|
type SpellcastingBlock,
|
||||||
type TraitBlock,
|
type TraitBlock,
|
||||||
|
type TraitListItem,
|
||||||
|
type TraitSegment,
|
||||||
} from "./creature-types.js";
|
} from "./creature-types.js";
|
||||||
export {
|
export {
|
||||||
type DeletePlayerCharacterSuccess,
|
type DeletePlayerCharacterSuccess,
|
||||||
@@ -49,9 +55,11 @@ export {
|
|||||||
editPlayerCharacter,
|
editPlayerCharacter,
|
||||||
} from "./edit-player-character.js";
|
} from "./edit-player-character.js";
|
||||||
export {
|
export {
|
||||||
|
type CombatantDescriptor,
|
||||||
calculateEncounterDifficulty,
|
calculateEncounterDifficulty,
|
||||||
crToXp,
|
crToXp,
|
||||||
type DifficultyResult,
|
type DifficultyResult,
|
||||||
|
type DifficultyThreshold,
|
||||||
type DifficultyTier,
|
type DifficultyTier,
|
||||||
VALID_CR_VALUES,
|
VALID_CR_VALUES,
|
||||||
} from "./encounter-difficulty.js";
|
} from "./encounter-difficulty.js";
|
||||||
@@ -75,6 +83,7 @@ export type {
|
|||||||
PlayerCharacterUpdated,
|
PlayerCharacterUpdated,
|
||||||
RoundAdvanced,
|
RoundAdvanced,
|
||||||
RoundRetreated,
|
RoundRetreated,
|
||||||
|
SideSet,
|
||||||
TempHpSet,
|
TempHpSet,
|
||||||
TurnAdvanced,
|
TurnAdvanced,
|
||||||
TurnRetreated,
|
TurnRetreated,
|
||||||
@@ -83,6 +92,7 @@ export type { ExportBundle } from "./export-bundle.js";
|
|||||||
export { deriveHpStatus, type HpStatus } from "./hp-status.js";
|
export { deriveHpStatus, type HpStatus } from "./hp-status.js";
|
||||||
export {
|
export {
|
||||||
calculateInitiative,
|
calculateInitiative,
|
||||||
|
calculatePf2eInitiative,
|
||||||
formatInitiativeModifier,
|
formatInitiativeModifier,
|
||||||
type InitiativeResult,
|
type InitiativeResult,
|
||||||
} from "./initiative.js";
|
} from "./initiative.js";
|
||||||
@@ -108,6 +118,7 @@ export {
|
|||||||
rollInitiative,
|
rollInitiative,
|
||||||
selectRoll,
|
selectRoll,
|
||||||
} from "./roll-initiative.js";
|
} from "./roll-initiative.js";
|
||||||
|
export type { RulesEdition } from "./rules-edition.js";
|
||||||
export { type SetAcSuccess, setAc } from "./set-ac.js";
|
export { type SetAcSuccess, setAc } from "./set-ac.js";
|
||||||
export { type SetCrSuccess, setCr } from "./set-cr.js";
|
export { type SetCrSuccess, setCr } from "./set-cr.js";
|
||||||
export { type SetHpSuccess, setHp } from "./set-hp.js";
|
export { type SetHpSuccess, setHp } from "./set-hp.js";
|
||||||
@@ -115,12 +126,15 @@ export {
|
|||||||
type SetInitiativeSuccess,
|
type SetInitiativeSuccess,
|
||||||
setInitiative,
|
setInitiative,
|
||||||
} from "./set-initiative.js";
|
} from "./set-initiative.js";
|
||||||
|
export { type SetSideSuccess, setSide } from "./set-side.js";
|
||||||
export { type SetTempHpSuccess, setTempHp } from "./set-temp-hp.js";
|
export { type SetTempHpSuccess, setTempHp } from "./set-temp-hp.js";
|
||||||
export {
|
export {
|
||||||
type ToggleConcentrationSuccess,
|
type ToggleConcentrationSuccess,
|
||||||
toggleConcentration,
|
toggleConcentration,
|
||||||
} from "./toggle-concentration.js";
|
} from "./toggle-concentration.js";
|
||||||
export {
|
export {
|
||||||
|
decrementCondition,
|
||||||
|
setConditionValue,
|
||||||
type ToggleConditionSuccess,
|
type ToggleConditionSuccess,
|
||||||
toggleCondition,
|
toggleCondition,
|
||||||
} from "./toggle-condition.js";
|
} from "./toggle-condition.js";
|
||||||
|
|||||||
@@ -20,6 +20,14 @@ export function calculateInitiative(creature: {
|
|||||||
return { modifier, passive: 10 + modifier };
|
return { modifier, passive: 10 + modifier };
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns the PF2e initiative result directly from the Perception modifier.
|
||||||
|
* No proficiency bonus calculation — PF2e uses Perception as-is.
|
||||||
|
*/
|
||||||
|
export function calculatePf2eInitiative(perception: number): InitiativeResult {
|
||||||
|
return { modifier: perception, passive: perception };
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Formats an initiative modifier with explicit sign.
|
* Formats an initiative modifier with explicit sign.
|
||||||
* Uses U+2212 (−) for negative values.
|
* Uses U+2212 (−) for negative values.
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
import type { ConditionId } from "./conditions.js";
|
import type { ConditionEntry, ConditionId } from "./conditions.js";
|
||||||
import { VALID_CONDITION_IDS } from "./conditions.js";
|
import { VALID_CONDITION_IDS } from "./conditions.js";
|
||||||
import { creatureId } from "./creature-types.js";
|
import { creatureId } from "./creature-types.js";
|
||||||
import { VALID_CR_VALUES } from "./encounter-difficulty.js";
|
import { VALID_CR_VALUES } from "./encounter-difficulty.js";
|
||||||
@@ -16,13 +16,30 @@ function validateAc(value: unknown): number | undefined {
|
|||||||
: undefined;
|
: undefined;
|
||||||
}
|
}
|
||||||
|
|
||||||
function validateConditions(value: unknown): ConditionId[] | undefined {
|
function validateConditions(value: unknown): ConditionEntry[] | undefined {
|
||||||
if (!Array.isArray(value)) return undefined;
|
if (!Array.isArray(value)) return undefined;
|
||||||
const valid = value.filter(
|
const entries: ConditionEntry[] = [];
|
||||||
(v): v is ConditionId =>
|
for (const item of value) {
|
||||||
typeof v === "string" && VALID_CONDITION_IDS.has(v),
|
if (typeof item === "string" && VALID_CONDITION_IDS.has(item)) {
|
||||||
);
|
entries.push({ id: item as ConditionId });
|
||||||
return valid.length > 0 ? valid : undefined;
|
} else if (
|
||||||
|
typeof item === "object" &&
|
||||||
|
item !== null &&
|
||||||
|
typeof (item as Record<string, unknown>).id === "string" &&
|
||||||
|
VALID_CONDITION_IDS.has((item as Record<string, unknown>).id as string)
|
||||||
|
) {
|
||||||
|
const id = (item as Record<string, unknown>).id as ConditionId;
|
||||||
|
const rawValue = (item as Record<string, unknown>).value;
|
||||||
|
const entry: ConditionEntry =
|
||||||
|
typeof rawValue === "number" &&
|
||||||
|
Number.isInteger(rawValue) &&
|
||||||
|
rawValue > 0
|
||||||
|
? { id, value: rawValue }
|
||||||
|
: { id };
|
||||||
|
entries.push(entry);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return entries.length > 0 ? entries : undefined;
|
||||||
}
|
}
|
||||||
|
|
||||||
function validateHp(
|
function validateHp(
|
||||||
@@ -76,6 +93,14 @@ function validateCr(value: unknown): string | undefined {
|
|||||||
: undefined;
|
: undefined;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
const VALID_SIDES = new Set(["party", "enemy"]);
|
||||||
|
|
||||||
|
function validateSide(value: unknown): "party" | "enemy" | undefined {
|
||||||
|
return typeof value === "string" && VALID_SIDES.has(value)
|
||||||
|
? (value as "party" | "enemy")
|
||||||
|
: undefined;
|
||||||
|
}
|
||||||
|
|
||||||
function parseOptionalFields(entry: Record<string, unknown>) {
|
function parseOptionalFields(entry: Record<string, unknown>) {
|
||||||
return {
|
return {
|
||||||
initiative: validateInteger(entry.initiative),
|
initiative: validateInteger(entry.initiative),
|
||||||
@@ -86,6 +111,7 @@ function parseOptionalFields(entry: Record<string, unknown>) {
|
|||||||
? creatureId(entry.creatureId as string)
|
? creatureId(entry.creatureId as string)
|
||||||
: undefined,
|
: undefined,
|
||||||
cr: validateCr(entry.cr),
|
cr: validateCr(entry.cr),
|
||||||
|
side: validateSide(entry.side),
|
||||||
color: validateSetMember(entry.color, VALID_PLAYER_COLORS),
|
color: validateSetMember(entry.color, VALID_PLAYER_COLORS),
|
||||||
icon: validateSetMember(entry.icon, VALID_PLAYER_ICONS),
|
icon: validateSetMember(entry.icon, VALID_PLAYER_ICONS),
|
||||||
playerCharacterId: validateNonEmptyString(entry.playerCharacterId)
|
playerCharacterId: validateNonEmptyString(entry.playerCharacterId)
|
||||||
|
|||||||
1
packages/domain/src/rules-edition.ts
Normal file
1
packages/domain/src/rules-edition.ts
Normal file
@@ -0,0 +1 @@
|
|||||||
|
export type RulesEdition = "5e" | "5.5e" | "pf2e";
|
||||||
54
packages/domain/src/set-side.ts
Normal file
54
packages/domain/src/set-side.ts
Normal file
@@ -0,0 +1,54 @@
|
|||||||
|
import type { DomainEvent } from "./events.js";
|
||||||
|
import {
|
||||||
|
type CombatantId,
|
||||||
|
type DomainError,
|
||||||
|
type Encounter,
|
||||||
|
findCombatant,
|
||||||
|
isDomainError,
|
||||||
|
} from "./types.js";
|
||||||
|
|
||||||
|
export interface SetSideSuccess {
|
||||||
|
readonly encounter: Encounter;
|
||||||
|
readonly events: DomainEvent[];
|
||||||
|
}
|
||||||
|
|
||||||
|
const VALID_SIDES = new Set(["party", "enemy"]);
|
||||||
|
|
||||||
|
export function setSide(
|
||||||
|
encounter: Encounter,
|
||||||
|
combatantId: CombatantId,
|
||||||
|
value: "party" | "enemy",
|
||||||
|
): SetSideSuccess | DomainError {
|
||||||
|
const found = findCombatant(encounter, combatantId);
|
||||||
|
if (isDomainError(found)) return found;
|
||||||
|
|
||||||
|
if (!VALID_SIDES.has(value)) {
|
||||||
|
return {
|
||||||
|
kind: "domain-error",
|
||||||
|
code: "invalid-side",
|
||||||
|
message: `Side must be "party" or "enemy", got "${value}"`,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
const previousSide = found.combatant.side;
|
||||||
|
|
||||||
|
const updatedCombatants = encounter.combatants.map((c) =>
|
||||||
|
c.id === combatantId ? { ...c, side: value } : c,
|
||||||
|
);
|
||||||
|
|
||||||
|
return {
|
||||||
|
encounter: {
|
||||||
|
combatants: updatedCombatants,
|
||||||
|
activeIndex: encounter.activeIndex,
|
||||||
|
roundNumber: encounter.roundNumber,
|
||||||
|
},
|
||||||
|
events: [
|
||||||
|
{
|
||||||
|
type: "SideSet",
|
||||||
|
combatantId,
|
||||||
|
previousSide,
|
||||||
|
newSide: value,
|
||||||
|
},
|
||||||
|
],
|
||||||
|
};
|
||||||
|
}
|
||||||
@@ -1,4 +1,4 @@
|
|||||||
import type { ConditionId } from "./conditions.js";
|
import type { ConditionEntry, ConditionId } from "./conditions.js";
|
||||||
import { CONDITION_DEFINITIONS, VALID_CONDITION_IDS } from "./conditions.js";
|
import { CONDITION_DEFINITIONS, VALID_CONDITION_IDS } from "./conditions.js";
|
||||||
import type { DomainEvent } from "./events.js";
|
import type { DomainEvent } from "./events.js";
|
||||||
import {
|
import {
|
||||||
@@ -14,11 +14,13 @@ export interface ToggleConditionSuccess {
|
|||||||
readonly events: DomainEvent[];
|
readonly events: DomainEvent[];
|
||||||
}
|
}
|
||||||
|
|
||||||
export function toggleCondition(
|
function sortByDefinitionOrder(entries: ConditionEntry[]): ConditionEntry[] {
|
||||||
encounter: Encounter,
|
const order = CONDITION_DEFINITIONS.map((d) => d.id);
|
||||||
combatantId: CombatantId,
|
entries.sort((a, b) => order.indexOf(a.id) - order.indexOf(b.id));
|
||||||
conditionId: ConditionId,
|
return entries;
|
||||||
): ToggleConditionSuccess | DomainError {
|
}
|
||||||
|
|
||||||
|
function validateConditionId(conditionId: ConditionId): DomainError | null {
|
||||||
if (!VALID_CONDITION_IDS.has(conditionId)) {
|
if (!VALID_CONDITION_IDS.has(conditionId)) {
|
||||||
return {
|
return {
|
||||||
kind: "domain-error",
|
kind: "domain-error",
|
||||||
@@ -26,38 +28,157 @@ export function toggleCondition(
|
|||||||
message: `Unknown condition "${conditionId}"`,
|
message: `Unknown condition "${conditionId}"`,
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
function applyConditions(
|
||||||
|
encounter: Encounter,
|
||||||
|
combatantId: CombatantId,
|
||||||
|
newConditions: readonly ConditionEntry[] | undefined,
|
||||||
|
): Encounter {
|
||||||
|
return {
|
||||||
|
combatants: encounter.combatants.map((c) =>
|
||||||
|
c.id === combatantId ? { ...c, conditions: newConditions } : c,
|
||||||
|
),
|
||||||
|
activeIndex: encounter.activeIndex,
|
||||||
|
roundNumber: encounter.roundNumber,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
export function toggleCondition(
|
||||||
|
encounter: Encounter,
|
||||||
|
combatantId: CombatantId,
|
||||||
|
conditionId: ConditionId,
|
||||||
|
): ToggleConditionSuccess | DomainError {
|
||||||
|
const err = validateConditionId(conditionId);
|
||||||
|
if (err) return err;
|
||||||
|
|
||||||
const found = findCombatant(encounter, combatantId);
|
const found = findCombatant(encounter, combatantId);
|
||||||
if (isDomainError(found)) return found;
|
if (isDomainError(found)) return found;
|
||||||
const { combatant: target } = found;
|
const { combatant: target } = found;
|
||||||
const current = target.conditions ?? [];
|
const current = target.conditions ?? [];
|
||||||
const isActive = current.includes(conditionId);
|
const isActive = current.some((c) => c.id === conditionId);
|
||||||
|
|
||||||
let newConditions: readonly ConditionId[] | undefined;
|
let newConditions: readonly ConditionEntry[] | undefined;
|
||||||
let event: DomainEvent;
|
let event: DomainEvent;
|
||||||
|
|
||||||
if (isActive) {
|
if (isActive) {
|
||||||
const filtered = current.filter((c) => c !== conditionId);
|
const filtered = current.filter((c) => c.id !== conditionId);
|
||||||
newConditions = filtered.length > 0 ? filtered : undefined;
|
newConditions = filtered.length > 0 ? filtered : undefined;
|
||||||
event = { type: "ConditionRemoved", combatantId, condition: conditionId };
|
event = { type: "ConditionRemoved", combatantId, condition: conditionId };
|
||||||
} else {
|
} else {
|
||||||
const added = [...current, conditionId];
|
const added = sortByDefinitionOrder([...current, { id: conditionId }]);
|
||||||
const order = CONDITION_DEFINITIONS.map((d) => d.id);
|
|
||||||
added.sort((a, b) => order.indexOf(a) - order.indexOf(b));
|
|
||||||
newConditions = added;
|
newConditions = added;
|
||||||
event = { type: "ConditionAdded", combatantId, condition: conditionId };
|
event = { type: "ConditionAdded", combatantId, condition: conditionId };
|
||||||
}
|
}
|
||||||
|
|
||||||
const updatedCombatants = encounter.combatants.map((c) =>
|
|
||||||
c.id === combatantId ? { ...c, conditions: newConditions } : c,
|
|
||||||
);
|
|
||||||
|
|
||||||
return {
|
return {
|
||||||
encounter: {
|
encounter: applyConditions(encounter, combatantId, newConditions),
|
||||||
combatants: updatedCombatants,
|
|
||||||
activeIndex: encounter.activeIndex,
|
|
||||||
roundNumber: encounter.roundNumber,
|
|
||||||
},
|
|
||||||
events: [event],
|
events: [event],
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
|
|
||||||
|
export function setConditionValue(
|
||||||
|
encounter: Encounter,
|
||||||
|
combatantId: CombatantId,
|
||||||
|
conditionId: ConditionId,
|
||||||
|
value: number,
|
||||||
|
): ToggleConditionSuccess | DomainError {
|
||||||
|
const err = validateConditionId(conditionId);
|
||||||
|
if (err) return err;
|
||||||
|
|
||||||
|
const found = findCombatant(encounter, combatantId);
|
||||||
|
if (isDomainError(found)) return found;
|
||||||
|
const { combatant: target } = found;
|
||||||
|
const current = target.conditions ?? [];
|
||||||
|
|
||||||
|
if (value <= 0) {
|
||||||
|
const filtered = current.filter((c) => c.id !== conditionId);
|
||||||
|
const newConditions = filtered.length > 0 ? filtered : undefined;
|
||||||
|
return {
|
||||||
|
encounter: applyConditions(encounter, combatantId, newConditions),
|
||||||
|
events: [
|
||||||
|
{ type: "ConditionRemoved", combatantId, condition: conditionId },
|
||||||
|
],
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
const existing = current.find((c) => c.id === conditionId);
|
||||||
|
if (existing) {
|
||||||
|
const updated = current.map((c) =>
|
||||||
|
c.id === conditionId ? { ...c, value } : c,
|
||||||
|
);
|
||||||
|
return {
|
||||||
|
encounter: applyConditions(encounter, combatantId, updated),
|
||||||
|
events: [
|
||||||
|
{
|
||||||
|
type: "ConditionAdded",
|
||||||
|
combatantId,
|
||||||
|
condition: conditionId,
|
||||||
|
value,
|
||||||
|
},
|
||||||
|
],
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
const added = sortByDefinitionOrder([...current, { id: conditionId, value }]);
|
||||||
|
return {
|
||||||
|
encounter: applyConditions(encounter, combatantId, added),
|
||||||
|
events: [
|
||||||
|
{ type: "ConditionAdded", combatantId, condition: conditionId, value },
|
||||||
|
],
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
export function decrementCondition(
|
||||||
|
encounter: Encounter,
|
||||||
|
combatantId: CombatantId,
|
||||||
|
conditionId: ConditionId,
|
||||||
|
): ToggleConditionSuccess | DomainError {
|
||||||
|
const err = validateConditionId(conditionId);
|
||||||
|
if (err) return err;
|
||||||
|
|
||||||
|
const found = findCombatant(encounter, combatantId);
|
||||||
|
if (isDomainError(found)) return found;
|
||||||
|
const { combatant: target } = found;
|
||||||
|
const current = target.conditions ?? [];
|
||||||
|
const existing = current.find((c) => c.id === conditionId);
|
||||||
|
|
||||||
|
if (!existing) {
|
||||||
|
return {
|
||||||
|
kind: "domain-error",
|
||||||
|
code: "condition-not-active",
|
||||||
|
message: `Condition "${conditionId}" is not active`,
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
const newValue = (existing.value ?? 1) - 1;
|
||||||
|
if (newValue <= 0) {
|
||||||
|
const filtered = current.filter((c) => c.id !== conditionId);
|
||||||
|
return {
|
||||||
|
encounter: applyConditions(
|
||||||
|
encounter,
|
||||||
|
combatantId,
|
||||||
|
filtered.length > 0 ? filtered : undefined,
|
||||||
|
),
|
||||||
|
events: [
|
||||||
|
{ type: "ConditionRemoved", combatantId, condition: conditionId },
|
||||||
|
],
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|
||||||
|
const updated = current.map((c) =>
|
||||||
|
c.id === conditionId ? { ...c, value: newValue } : c,
|
||||||
|
);
|
||||||
|
return {
|
||||||
|
encounter: applyConditions(encounter, combatantId, updated),
|
||||||
|
events: [
|
||||||
|
{
|
||||||
|
type: "ConditionAdded",
|
||||||
|
combatantId,
|
||||||
|
condition: conditionId,
|
||||||
|
value: newValue,
|
||||||
|
},
|
||||||
|
],
|
||||||
|
};
|
||||||
|
}
|
||||||
|
|||||||
@@ -5,7 +5,7 @@ export function combatantId(id: string): CombatantId {
|
|||||||
return id as CombatantId;
|
return id as CombatantId;
|
||||||
}
|
}
|
||||||
|
|
||||||
import type { ConditionId } from "./conditions.js";
|
import type { ConditionEntry } from "./conditions.js";
|
||||||
import type { CreatureId } from "./creature-types.js";
|
import type { CreatureId } from "./creature-types.js";
|
||||||
import type { PlayerCharacterId } from "./player-character-types.js";
|
import type { PlayerCharacterId } from "./player-character-types.js";
|
||||||
|
|
||||||
@@ -17,10 +17,11 @@ export interface Combatant {
|
|||||||
readonly currentHp?: number;
|
readonly currentHp?: number;
|
||||||
readonly tempHp?: number;
|
readonly tempHp?: number;
|
||||||
readonly ac?: number;
|
readonly ac?: number;
|
||||||
readonly conditions?: readonly ConditionId[];
|
readonly conditions?: readonly ConditionEntry[];
|
||||||
readonly isConcentrating?: boolean;
|
readonly isConcentrating?: boolean;
|
||||||
readonly creatureId?: CreatureId;
|
readonly creatureId?: CreatureId;
|
||||||
readonly cr?: string;
|
readonly cr?: string;
|
||||||
|
readonly side?: "party" | "enemy";
|
||||||
readonly color?: string;
|
readonly color?: string;
|
||||||
readonly icon?: string;
|
readonly icon?: string;
|
||||||
readonly playerCharacterId?: PlayerCharacterId;
|
readonly playerCharacterId?: PlayerCharacterId;
|
||||||
|
|||||||
218
pnpm-lock.yaml
generated
218
pnpm-lock.yaml
generated
@@ -17,7 +17,7 @@ importers:
|
|||||||
version: 2.4.8
|
version: 2.4.8
|
||||||
'@vitest/coverage-v8':
|
'@vitest/coverage-v8':
|
||||||
specifier: ^4.1.0
|
specifier: ^4.1.0
|
||||||
version: 4.1.0(vitest@4.1.0(@types/node@25.3.3)(jsdom@29.0.1)(vite@8.0.1(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3)))
|
version: 4.1.0(vitest@4.1.0(@types/node@25.3.3)(jsdom@29.0.1)(vite@8.0.5(@emnapi/core@1.8.1)(@emnapi/runtime@1.8.1)(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3)))
|
||||||
jscpd:
|
jscpd:
|
||||||
specifier: ^4.0.8
|
specifier: ^4.0.8
|
||||||
version: 4.0.8
|
version: 4.0.8
|
||||||
@@ -41,7 +41,7 @@ importers:
|
|||||||
version: 5.9.3
|
version: 5.9.3
|
||||||
vitest:
|
vitest:
|
||||||
specifier: ^4.1.0
|
specifier: ^4.1.0
|
||||||
version: 4.1.0(@types/node@25.3.3)(jsdom@29.0.1)(vite@8.0.1(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3))
|
version: 4.1.0(@types/node@25.3.3)(jsdom@29.0.1)(vite@8.0.5(@emnapi/core@1.8.1)(@emnapi/runtime@1.8.1)(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3))
|
||||||
|
|
||||||
apps/web:
|
apps/web:
|
||||||
dependencies:
|
dependencies:
|
||||||
@@ -75,7 +75,7 @@ importers:
|
|||||||
devDependencies:
|
devDependencies:
|
||||||
'@tailwindcss/vite':
|
'@tailwindcss/vite':
|
||||||
specifier: ^4.2.2
|
specifier: ^4.2.2
|
||||||
version: 4.2.2(vite@8.0.1(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3))
|
version: 4.2.2(vite@8.0.5(@emnapi/core@1.8.1)(@emnapi/runtime@1.8.1)(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3))
|
||||||
'@testing-library/jest-dom':
|
'@testing-library/jest-dom':
|
||||||
specifier: ^6.9.1
|
specifier: ^6.9.1
|
||||||
version: 6.9.1
|
version: 6.9.1
|
||||||
@@ -93,7 +93,7 @@ importers:
|
|||||||
version: 19.2.3(@types/react@19.2.14)
|
version: 19.2.3(@types/react@19.2.14)
|
||||||
'@vitejs/plugin-react':
|
'@vitejs/plugin-react':
|
||||||
specifier: ^6.0.1
|
specifier: ^6.0.1
|
||||||
version: 6.0.1(vite@8.0.1(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3))
|
version: 6.0.1(vite@8.0.5(@emnapi/core@1.8.1)(@emnapi/runtime@1.8.1)(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3))
|
||||||
jsdom:
|
jsdom:
|
||||||
specifier: ^29.0.1
|
specifier: ^29.0.1
|
||||||
version: 29.0.1
|
version: 29.0.1
|
||||||
@@ -101,8 +101,8 @@ importers:
|
|||||||
specifier: ^4.2.2
|
specifier: ^4.2.2
|
||||||
version: 4.2.2
|
version: 4.2.2
|
||||||
vite:
|
vite:
|
||||||
specifier: ^8.0.1
|
specifier: ^8.0.5
|
||||||
version: 8.0.1(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3)
|
version: 8.0.5(@emnapi/core@1.8.1)(@emnapi/runtime@1.8.1)(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3)
|
||||||
|
|
||||||
packages/application:
|
packages/application:
|
||||||
dependencies:
|
dependencies:
|
||||||
@@ -162,6 +162,10 @@ packages:
|
|||||||
resolution: {integrity: sha512-05WQkdpL9COIMz4LjTxGpPNCdlpyimKppYNoJ5Di5EUObifl8t4tuLuUBBZEpoLYOmfvIWrsp9fCl0HoPRVTdA==}
|
resolution: {integrity: sha512-05WQkdpL9COIMz4LjTxGpPNCdlpyimKppYNoJ5Di5EUObifl8t4tuLuUBBZEpoLYOmfvIWrsp9fCl0HoPRVTdA==}
|
||||||
engines: {node: '>=6.9.0'}
|
engines: {node: '>=6.9.0'}
|
||||||
|
|
||||||
|
'@babel/runtime@7.29.2':
|
||||||
|
resolution: {integrity: sha512-JiDShH45zKHWyGe4ZNVRrCjBz8Nh9TMmZG1kh4QTK8hCBTWBi8Da+i7s1fJw7/lYpM4ccepSNfqzZ/QvABBi5g==}
|
||||||
|
engines: {node: '>=6.9.0'}
|
||||||
|
|
||||||
'@babel/types@7.29.0':
|
'@babel/types@7.29.0':
|
||||||
resolution: {integrity: sha512-LwdZHpScM4Qz8Xw2iKSzS+cfglZzJGvofQICy7W7v4caru4EaAmyUuO6BGrbyQ2mYV11W0U8j5mBhd14dd3B0A==}
|
resolution: {integrity: sha512-LwdZHpScM4Qz8Xw2iKSzS+cfglZzJGvofQICy7W7v4caru4EaAmyUuO6BGrbyQ2mYV11W0U8j5mBhd14dd3B0A==}
|
||||||
engines: {node: '>=6.9.0'}
|
engines: {node: '>=6.9.0'}
|
||||||
@@ -327,6 +331,12 @@ packages:
|
|||||||
'@napi-rs/wasm-runtime@1.1.1':
|
'@napi-rs/wasm-runtime@1.1.1':
|
||||||
resolution: {integrity: sha512-p64ah1M1ld8xjWv3qbvFwHiFVWrq1yFvV4f7w+mzaqiR4IlSgkqhcRdHwsGgomwzBH51sRY4NEowLxnaBjcW/A==}
|
resolution: {integrity: sha512-p64ah1M1ld8xjWv3qbvFwHiFVWrq1yFvV4f7w+mzaqiR4IlSgkqhcRdHwsGgomwzBH51sRY4NEowLxnaBjcW/A==}
|
||||||
|
|
||||||
|
'@napi-rs/wasm-runtime@1.1.2':
|
||||||
|
resolution: {integrity: sha512-sNXv5oLJ7ob93xkZ1XnxisYhGYXfaG9f65/ZgYuAu3qt7b3NadcOEhLvx28hv31PgX8SZJRYrAIPQilQmFpLVw==}
|
||||||
|
peerDependencies:
|
||||||
|
'@emnapi/core': ^1.7.1
|
||||||
|
'@emnapi/runtime': ^1.7.1
|
||||||
|
|
||||||
'@nodelib/fs.scandir@2.1.5':
|
'@nodelib/fs.scandir@2.1.5':
|
||||||
resolution: {integrity: sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==}
|
resolution: {integrity: sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==}
|
||||||
engines: {node: '>= 8'}
|
engines: {node: '>= 8'}
|
||||||
@@ -339,8 +349,8 @@ packages:
|
|||||||
resolution: {integrity: sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==}
|
resolution: {integrity: sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==}
|
||||||
engines: {node: '>= 8'}
|
engines: {node: '>= 8'}
|
||||||
|
|
||||||
'@oxc-project/types@0.120.0':
|
'@oxc-project/types@0.122.0':
|
||||||
resolution: {integrity: sha512-k1YNu55DuvAip/MGE1FTsIuU3FUCn6v/ujG9V7Nq5Df/kX2CWb13hhwD0lmJGMGqE+bE1MXvv9SZVnMzEXlWcg==}
|
resolution: {integrity: sha512-oLAl5kBpV4w69UtFZ9xqcmTi+GENWOcPF7FCrczTiBbmC0ibXxCwyvZGbO39rCVEuLGAZM84DH0pUIyyv/YJzA==}
|
||||||
|
|
||||||
'@oxc-resolver/binding-android-arm-eabi@11.19.1':
|
'@oxc-resolver/binding-android-arm-eabi@11.19.1':
|
||||||
resolution: {integrity: sha512-aUs47y+xyXHUKlbhqHUjBABjvycq6YSD7bpxSW7vplUmdzAlJ93yXY6ZR0c1o1x5A/QKbENCvs3+NlY8IpIVzg==}
|
resolution: {integrity: sha512-aUs47y+xyXHUKlbhqHUjBABjvycq6YSD7bpxSW7vplUmdzAlJ93yXY6ZR0c1o1x5A/QKbENCvs3+NlY8IpIVzg==}
|
||||||
@@ -602,103 +612,103 @@ packages:
|
|||||||
cpu: [x64]
|
cpu: [x64]
|
||||||
os: [win32]
|
os: [win32]
|
||||||
|
|
||||||
'@rolldown/binding-android-arm64@1.0.0-rc.10':
|
'@rolldown/binding-android-arm64@1.0.0-rc.12':
|
||||||
resolution: {integrity: sha512-jOHxwXhxmFKuXztiu1ORieJeTbx5vrTkcOkkkn2d35726+iwhrY1w/+nYY/AGgF12thg33qC3R1LMBF5tHTZHg==}
|
resolution: {integrity: sha512-pv1y2Fv0JybcykuiiD3qBOBdz6RteYojRFY1d+b95WVuzx211CRh+ytI/+9iVyWQ6koTh5dawe4S/yRfOFjgaA==}
|
||||||
engines: {node: ^20.19.0 || >=22.12.0}
|
engines: {node: ^20.19.0 || >=22.12.0}
|
||||||
cpu: [arm64]
|
cpu: [arm64]
|
||||||
os: [android]
|
os: [android]
|
||||||
|
|
||||||
'@rolldown/binding-darwin-arm64@1.0.0-rc.10':
|
'@rolldown/binding-darwin-arm64@1.0.0-rc.12':
|
||||||
resolution: {integrity: sha512-gED05Teg/vtTZbIJBc4VNMAxAFDUPkuO/rAIyyxZjTj1a1/s6z5TII/5yMGZ0uLRCifEtwUQn8OlYzuYc0m70w==}
|
resolution: {integrity: sha512-cFYr6zTG/3PXXF3pUO+umXxt1wkRK/0AYT8lDwuqvRC+LuKYWSAQAQZjCWDQpAH172ZV6ieYrNnFzVVcnSflAg==}
|
||||||
engines: {node: ^20.19.0 || >=22.12.0}
|
engines: {node: ^20.19.0 || >=22.12.0}
|
||||||
cpu: [arm64]
|
cpu: [arm64]
|
||||||
os: [darwin]
|
os: [darwin]
|
||||||
|
|
||||||
'@rolldown/binding-darwin-x64@1.0.0-rc.10':
|
'@rolldown/binding-darwin-x64@1.0.0-rc.12':
|
||||||
resolution: {integrity: sha512-rI15NcM1mA48lqrIxVkHfAqcyFLcQwyXWThy+BQ5+mkKKPvSO26ir+ZDp36AgYoYVkqvMcdS8zOE6SeBsR9e8A==}
|
resolution: {integrity: sha512-ZCsYknnHzeXYps0lGBz8JrF37GpE9bFVefrlmDrAQhOEi4IOIlcoU1+FwHEtyXGx2VkYAvhu7dyBf75EJQffBw==}
|
||||||
engines: {node: ^20.19.0 || >=22.12.0}
|
engines: {node: ^20.19.0 || >=22.12.0}
|
||||||
cpu: [x64]
|
cpu: [x64]
|
||||||
os: [darwin]
|
os: [darwin]
|
||||||
|
|
||||||
'@rolldown/binding-freebsd-x64@1.0.0-rc.10':
|
'@rolldown/binding-freebsd-x64@1.0.0-rc.12':
|
||||||
resolution: {integrity: sha512-XZRXHdTa+4ME1MuDVp021+doQ+z6Ei4CCFmNc5/sKbqb8YmkiJdj8QKlV3rCI0AJtAeSB5n0WGPuJWNL9p/L2w==}
|
resolution: {integrity: sha512-dMLeprcVsyJsKolRXyoTH3NL6qtsT0Y2xeuEA8WQJquWFXkEC4bcu1rLZZSnZRMtAqwtrF/Ib9Ddtpa/Gkge9Q==}
|
||||||
engines: {node: ^20.19.0 || >=22.12.0}
|
engines: {node: ^20.19.0 || >=22.12.0}
|
||||||
cpu: [x64]
|
cpu: [x64]
|
||||||
os: [freebsd]
|
os: [freebsd]
|
||||||
|
|
||||||
'@rolldown/binding-linux-arm-gnueabihf@1.0.0-rc.10':
|
'@rolldown/binding-linux-arm-gnueabihf@1.0.0-rc.12':
|
||||||
resolution: {integrity: sha512-R0SQMRluISSLzFE20sPWYHVmJdDQnRyc/FzSCN72BqQmh2SOZUFG+N3/vBZpR4C6WpEUVYJLrYUXaj43sJsNLA==}
|
resolution: {integrity: sha512-YqWjAgGC/9M1lz3GR1r1rP79nMgo3mQiiA+Hfo+pvKFK1fAJ1bCi0ZQVh8noOqNacuY1qIcfyVfP6HoyBRZ85Q==}
|
||||||
engines: {node: ^20.19.0 || >=22.12.0}
|
engines: {node: ^20.19.0 || >=22.12.0}
|
||||||
cpu: [arm]
|
cpu: [arm]
|
||||||
os: [linux]
|
os: [linux]
|
||||||
|
|
||||||
'@rolldown/binding-linux-arm64-gnu@1.0.0-rc.10':
|
'@rolldown/binding-linux-arm64-gnu@1.0.0-rc.12':
|
||||||
resolution: {integrity: sha512-Y1reMrV/o+cwpduYhJuOE3OMKx32RMYCidf14y+HssARRmhDuWXJ4yVguDg2R/8SyyGNo+auzz64LnPK9Hq6jg==}
|
resolution: {integrity: sha512-/I5AS4cIroLpslsmzXfwbe5OmWvSsrFuEw3mwvbQ1kDxJ822hFHIx+vsN/TAzNVyepI/j/GSzrtCIwQPeKCLIg==}
|
||||||
engines: {node: ^20.19.0 || >=22.12.0}
|
engines: {node: ^20.19.0 || >=22.12.0}
|
||||||
cpu: [arm64]
|
cpu: [arm64]
|
||||||
os: [linux]
|
os: [linux]
|
||||||
libc: [glibc]
|
libc: [glibc]
|
||||||
|
|
||||||
'@rolldown/binding-linux-arm64-musl@1.0.0-rc.10':
|
'@rolldown/binding-linux-arm64-musl@1.0.0-rc.12':
|
||||||
resolution: {integrity: sha512-vELN+HNb2IzuzSBUOD4NHmP9yrGwl1DVM29wlQvx1OLSclL0NgVWnVDKl/8tEks79EFek/kebQKnNJkIAA4W2g==}
|
resolution: {integrity: sha512-V6/wZztnBqlx5hJQqNWwFdxIKN0m38p8Jas+VoSfgH54HSj9tKTt1dZvG6JRHcjh6D7TvrJPWFGaY9UBVOaWPw==}
|
||||||
engines: {node: ^20.19.0 || >=22.12.0}
|
engines: {node: ^20.19.0 || >=22.12.0}
|
||||||
cpu: [arm64]
|
cpu: [arm64]
|
||||||
os: [linux]
|
os: [linux]
|
||||||
libc: [musl]
|
libc: [musl]
|
||||||
|
|
||||||
'@rolldown/binding-linux-ppc64-gnu@1.0.0-rc.10':
|
'@rolldown/binding-linux-ppc64-gnu@1.0.0-rc.12':
|
||||||
resolution: {integrity: sha512-ZqrufYTgzxbHwpqOjzSsb0UV/aV2TFIY5rP8HdsiPTv/CuAgCRjM6s9cYFwQ4CNH+hf9Y4erHW1GjZuZ7WoI7w==}
|
resolution: {integrity: sha512-AP3E9BpcUYliZCxa3w5Kwj9OtEVDYK6sVoUzy4vTOJsjPOgdaJZKFmN4oOlX0Wp0RPV2ETfmIra9x1xuayFB7g==}
|
||||||
engines: {node: ^20.19.0 || >=22.12.0}
|
engines: {node: ^20.19.0 || >=22.12.0}
|
||||||
cpu: [ppc64]
|
cpu: [ppc64]
|
||||||
os: [linux]
|
os: [linux]
|
||||||
libc: [glibc]
|
libc: [glibc]
|
||||||
|
|
||||||
'@rolldown/binding-linux-s390x-gnu@1.0.0-rc.10':
|
'@rolldown/binding-linux-s390x-gnu@1.0.0-rc.12':
|
||||||
resolution: {integrity: sha512-gSlmVS1FZJSRicA6IyjoRoKAFK7IIHBs7xJuHRSmjImqk3mPPWbR7RhbnfH2G6bcmMEllCt2vQ/7u9e6bBnByg==}
|
resolution: {integrity: sha512-nWwpvUSPkoFmZo0kQazZYOrT7J5DGOJ/+QHHzjvNlooDZED8oH82Yg67HvehPPLAg5fUff7TfWFHQS8IV1n3og==}
|
||||||
engines: {node: ^20.19.0 || >=22.12.0}
|
engines: {node: ^20.19.0 || >=22.12.0}
|
||||||
cpu: [s390x]
|
cpu: [s390x]
|
||||||
os: [linux]
|
os: [linux]
|
||||||
libc: [glibc]
|
libc: [glibc]
|
||||||
|
|
||||||
'@rolldown/binding-linux-x64-gnu@1.0.0-rc.10':
|
'@rolldown/binding-linux-x64-gnu@1.0.0-rc.12':
|
||||||
resolution: {integrity: sha512-eOCKUpluKgfObT2pHjztnaWEIbUabWzk3qPZ5PuacuPmr4+JtQG4k2vGTY0H15edaTnicgU428XW/IH6AimcQw==}
|
resolution: {integrity: sha512-RNrafz5bcwRy+O9e6P8Z/OCAJW/A+qtBczIqVYwTs14pf4iV1/+eKEjdOUta93q2TsT/FI0XYDP3TCky38LMAg==}
|
||||||
engines: {node: ^20.19.0 || >=22.12.0}
|
engines: {node: ^20.19.0 || >=22.12.0}
|
||||||
cpu: [x64]
|
cpu: [x64]
|
||||||
os: [linux]
|
os: [linux]
|
||||||
libc: [glibc]
|
libc: [glibc]
|
||||||
|
|
||||||
'@rolldown/binding-linux-x64-musl@1.0.0-rc.10':
|
'@rolldown/binding-linux-x64-musl@1.0.0-rc.12':
|
||||||
resolution: {integrity: sha512-Xdf2jQbfQowJnLcgYfD/m0Uu0Qj5OdxKallD78/IPPfzaiaI4KRAwZzHcKQ4ig1gtg1SuzC7jovNiM2TzQsBXA==}
|
resolution: {integrity: sha512-Jpw/0iwoKWx3LJ2rc1yjFrj+T7iHZn2JDg1Yny1ma0luviFS4mhAIcd1LFNxK3EYu3DHWCps0ydXQ5i/rrJ2ig==}
|
||||||
engines: {node: ^20.19.0 || >=22.12.0}
|
engines: {node: ^20.19.0 || >=22.12.0}
|
||||||
cpu: [x64]
|
cpu: [x64]
|
||||||
os: [linux]
|
os: [linux]
|
||||||
libc: [musl]
|
libc: [musl]
|
||||||
|
|
||||||
'@rolldown/binding-openharmony-arm64@1.0.0-rc.10':
|
'@rolldown/binding-openharmony-arm64@1.0.0-rc.12':
|
||||||
resolution: {integrity: sha512-o1hYe8hLi1EY6jgPFyxQgQ1wcycX+qz8eEbVmot2hFkgUzPxy9+kF0u0NIQBeDq+Mko47AkaFFaChcvZa9UX9Q==}
|
resolution: {integrity: sha512-vRugONE4yMfVn0+7lUKdKvN4D5YusEiPilaoO2sgUWpCvrncvWgPMzK00ZFFJuiPgLwgFNP5eSiUlv2tfc+lpA==}
|
||||||
engines: {node: ^20.19.0 || >=22.12.0}
|
engines: {node: ^20.19.0 || >=22.12.0}
|
||||||
cpu: [arm64]
|
cpu: [arm64]
|
||||||
os: [openharmony]
|
os: [openharmony]
|
||||||
|
|
||||||
'@rolldown/binding-wasm32-wasi@1.0.0-rc.10':
|
'@rolldown/binding-wasm32-wasi@1.0.0-rc.12':
|
||||||
resolution: {integrity: sha512-Ugv9o7qYJudqQO5Y5y2N2SOo6S4WiqiNOpuQyoPInnhVzCY+wi/GHltcLHypG9DEUYMB0iTB/huJrpadiAcNcA==}
|
resolution: {integrity: sha512-ykGiLr/6kkiHc0XnBfmFJuCjr5ZYKKofkx+chJWDjitX+KsJuAmrzWhwyOMSHzPhzOHOy7u9HlFoa5MoAOJ/Zg==}
|
||||||
engines: {node: '>=14.0.0'}
|
engines: {node: '>=14.0.0'}
|
||||||
cpu: [wasm32]
|
cpu: [wasm32]
|
||||||
|
|
||||||
'@rolldown/binding-win32-arm64-msvc@1.0.0-rc.10':
|
'@rolldown/binding-win32-arm64-msvc@1.0.0-rc.12':
|
||||||
resolution: {integrity: sha512-7UODQb4fQUNT/vmgDZBl3XOBAIOutP5R3O/rkxg0aLfEGQ4opbCgU5vOw/scPe4xOqBwL9fw7/RP1vAMZ6QlAQ==}
|
resolution: {integrity: sha512-5eOND4duWkwx1AzCxadcOrNeighiLwMInEADT0YM7xeEOOFcovWZCq8dadXgcRHSf3Ulh1kFo/qvzoFiCLOL1Q==}
|
||||||
engines: {node: ^20.19.0 || >=22.12.0}
|
engines: {node: ^20.19.0 || >=22.12.0}
|
||||||
cpu: [arm64]
|
cpu: [arm64]
|
||||||
os: [win32]
|
os: [win32]
|
||||||
|
|
||||||
'@rolldown/binding-win32-x64-msvc@1.0.0-rc.10':
|
'@rolldown/binding-win32-x64-msvc@1.0.0-rc.12':
|
||||||
resolution: {integrity: sha512-PYxKHMVHOb5NJuDL53vBUl1VwUjymDcYI6rzpIni0C9+9mTiJedvUxSk7/RPp7OOAm3v+EjgMu9bIy3N6b408w==}
|
resolution: {integrity: sha512-PyqoipaswDLAZtot351MLhrlrh6lcZPo2LSYE+VDxbVk24LVKAGOuE4hb8xZQmrPAuEtTZW8E6D2zc5EUZX4Lw==}
|
||||||
engines: {node: ^20.19.0 || >=22.12.0}
|
engines: {node: ^20.19.0 || >=22.12.0}
|
||||||
cpu: [x64]
|
cpu: [x64]
|
||||||
os: [win32]
|
os: [win32]
|
||||||
|
|
||||||
'@rolldown/pluginutils@1.0.0-rc.10':
|
'@rolldown/pluginutils@1.0.0-rc.12':
|
||||||
resolution: {integrity: sha512-UkVDEFk1w3mveXeKgaTuYfKWtPbvgck1dT8TUG3bnccrH0XtLTuAyfCoks4Q/M5ZGToSVJTIQYCzy2g/atAOeg==}
|
resolution: {integrity: sha512-HHMwmarRKvoFsJorqYlFeFRzXZqCt2ETQlEDOb9aqssrnVBB1/+xgTGtuTrIk5vzLNX1MjMtTf7W9z3tsSbrxw==}
|
||||||
|
|
||||||
'@rolldown/pluginutils@1.0.0-rc.7':
|
'@rolldown/pluginutils@1.0.0-rc.7':
|
||||||
resolution: {integrity: sha512-qujRfC8sFVInYSPPMLQByRh7zhwkGFS4+tyMQ83srV1qrxL4g8E2tyxVVyxd0+8QeBM1mIk9KbWxkegRr76XzA==}
|
resolution: {integrity: sha512-qujRfC8sFVInYSPPMLQByRh7zhwkGFS4+tyMQ83srV1qrxL4g8E2tyxVVyxd0+8QeBM1mIk9KbWxkegRr76XzA==}
|
||||||
@@ -1657,8 +1667,8 @@ packages:
|
|||||||
resolution: {integrity: sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==}
|
resolution: {integrity: sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==}
|
||||||
engines: {iojs: '>=1.0.0', node: '>=0.10.0'}
|
engines: {iojs: '>=1.0.0', node: '>=0.10.0'}
|
||||||
|
|
||||||
rolldown@1.0.0-rc.10:
|
rolldown@1.0.0-rc.12:
|
||||||
resolution: {integrity: sha512-q7j6vvarRFmKpgJUT8HCAUljkgzEp4LAhPlJUvQhA5LA1SUL36s5QCysMutErzL3EbNOZOkoziSx9iZC4FddKA==}
|
resolution: {integrity: sha512-yP4USLIMYrwpPHEFB5JGH1uxhcslv6/hL0OyvTuY+3qlOSJvZ7ntYnoWpehBxufkgN0cvXxppuTu5hHa/zPh+A==}
|
||||||
engines: {node: ^20.19.0 || >=22.12.0}
|
engines: {node: ^20.19.0 || >=22.12.0}
|
||||||
hasBin: true
|
hasBin: true
|
||||||
|
|
||||||
@@ -1821,14 +1831,14 @@ packages:
|
|||||||
resolution: {integrity: sha512-gptHNQghINnc/vTGIk0SOFGFNXw7JVrlRUtConJRlvaw6DuX0wO5Jeko9sWrMBhh+PsYAZ7oXAiOnf/UKogyiw==}
|
resolution: {integrity: sha512-gptHNQghINnc/vTGIk0SOFGFNXw7JVrlRUtConJRlvaw6DuX0wO5Jeko9sWrMBhh+PsYAZ7oXAiOnf/UKogyiw==}
|
||||||
engines: {node: '>= 10.0.0'}
|
engines: {node: '>= 10.0.0'}
|
||||||
|
|
||||||
vite@8.0.1:
|
vite@8.0.5:
|
||||||
resolution: {integrity: sha512-wt+Z2qIhfFt85uiyRt5LPU4oVEJBXj8hZNWKeqFG4gRG/0RaRGJ7njQCwzFVjO+v4+Ipmf5CY7VdmZRAYYBPHw==}
|
resolution: {integrity: sha512-nmu43Qvq9UopTRfMx2jOYW5l16pb3iDC1JH6yMuPkpVbzK0k+L7dfsEDH4jRgYFmsg0sTAqkojoZgzLMlwHsCQ==}
|
||||||
engines: {node: ^20.19.0 || >=22.12.0}
|
engines: {node: ^20.19.0 || >=22.12.0}
|
||||||
hasBin: true
|
hasBin: true
|
||||||
peerDependencies:
|
peerDependencies:
|
||||||
'@types/node': ^20.19.0 || >=22.12.0
|
'@types/node': ^20.19.0 || >=22.12.0
|
||||||
'@vitejs/devtools': ^0.1.0
|
'@vitejs/devtools': ^0.1.0
|
||||||
esbuild: ^0.27.0
|
esbuild: ^0.27.0 || ^0.28.0
|
||||||
jiti: '>=1.21.0'
|
jiti: '>=1.21.0'
|
||||||
less: ^4.0.0
|
less: ^4.0.0
|
||||||
sass: ^1.70.0
|
sass: ^1.70.0
|
||||||
@@ -2001,6 +2011,8 @@ snapshots:
|
|||||||
|
|
||||||
'@babel/runtime@7.28.6': {}
|
'@babel/runtime@7.28.6': {}
|
||||||
|
|
||||||
|
'@babel/runtime@7.29.2': {}
|
||||||
|
|
||||||
'@babel/types@7.29.0':
|
'@babel/types@7.29.0':
|
||||||
dependencies:
|
dependencies:
|
||||||
'@babel/helper-string-parser': 7.27.1
|
'@babel/helper-string-parser': 7.27.1
|
||||||
@@ -2158,6 +2170,13 @@ snapshots:
|
|||||||
'@tybys/wasm-util': 0.10.1
|
'@tybys/wasm-util': 0.10.1
|
||||||
optional: true
|
optional: true
|
||||||
|
|
||||||
|
'@napi-rs/wasm-runtime@1.1.2(@emnapi/core@1.8.1)(@emnapi/runtime@1.8.1)':
|
||||||
|
dependencies:
|
||||||
|
'@emnapi/core': 1.8.1
|
||||||
|
'@emnapi/runtime': 1.8.1
|
||||||
|
'@tybys/wasm-util': 0.10.1
|
||||||
|
optional: true
|
||||||
|
|
||||||
'@nodelib/fs.scandir@2.1.5':
|
'@nodelib/fs.scandir@2.1.5':
|
||||||
dependencies:
|
dependencies:
|
||||||
'@nodelib/fs.stat': 2.0.5
|
'@nodelib/fs.stat': 2.0.5
|
||||||
@@ -2170,7 +2189,7 @@ snapshots:
|
|||||||
'@nodelib/fs.scandir': 2.1.5
|
'@nodelib/fs.scandir': 2.1.5
|
||||||
fastq: 1.20.1
|
fastq: 1.20.1
|
||||||
|
|
||||||
'@oxc-project/types@0.120.0': {}
|
'@oxc-project/types@0.122.0': {}
|
||||||
|
|
||||||
'@oxc-resolver/binding-android-arm-eabi@11.19.1':
|
'@oxc-resolver/binding-android-arm-eabi@11.19.1':
|
||||||
optional: true
|
optional: true
|
||||||
@@ -2309,54 +2328,57 @@ snapshots:
|
|||||||
'@oxlint/binding-win32-x64-msvc@1.56.0':
|
'@oxlint/binding-win32-x64-msvc@1.56.0':
|
||||||
optional: true
|
optional: true
|
||||||
|
|
||||||
'@rolldown/binding-android-arm64@1.0.0-rc.10':
|
'@rolldown/binding-android-arm64@1.0.0-rc.12':
|
||||||
optional: true
|
optional: true
|
||||||
|
|
||||||
'@rolldown/binding-darwin-arm64@1.0.0-rc.10':
|
'@rolldown/binding-darwin-arm64@1.0.0-rc.12':
|
||||||
optional: true
|
optional: true
|
||||||
|
|
||||||
'@rolldown/binding-darwin-x64@1.0.0-rc.10':
|
'@rolldown/binding-darwin-x64@1.0.0-rc.12':
|
||||||
optional: true
|
optional: true
|
||||||
|
|
||||||
'@rolldown/binding-freebsd-x64@1.0.0-rc.10':
|
'@rolldown/binding-freebsd-x64@1.0.0-rc.12':
|
||||||
optional: true
|
optional: true
|
||||||
|
|
||||||
'@rolldown/binding-linux-arm-gnueabihf@1.0.0-rc.10':
|
'@rolldown/binding-linux-arm-gnueabihf@1.0.0-rc.12':
|
||||||
optional: true
|
optional: true
|
||||||
|
|
||||||
'@rolldown/binding-linux-arm64-gnu@1.0.0-rc.10':
|
'@rolldown/binding-linux-arm64-gnu@1.0.0-rc.12':
|
||||||
optional: true
|
optional: true
|
||||||
|
|
||||||
'@rolldown/binding-linux-arm64-musl@1.0.0-rc.10':
|
'@rolldown/binding-linux-arm64-musl@1.0.0-rc.12':
|
||||||
optional: true
|
optional: true
|
||||||
|
|
||||||
'@rolldown/binding-linux-ppc64-gnu@1.0.0-rc.10':
|
'@rolldown/binding-linux-ppc64-gnu@1.0.0-rc.12':
|
||||||
optional: true
|
optional: true
|
||||||
|
|
||||||
'@rolldown/binding-linux-s390x-gnu@1.0.0-rc.10':
|
'@rolldown/binding-linux-s390x-gnu@1.0.0-rc.12':
|
||||||
optional: true
|
optional: true
|
||||||
|
|
||||||
'@rolldown/binding-linux-x64-gnu@1.0.0-rc.10':
|
'@rolldown/binding-linux-x64-gnu@1.0.0-rc.12':
|
||||||
optional: true
|
optional: true
|
||||||
|
|
||||||
'@rolldown/binding-linux-x64-musl@1.0.0-rc.10':
|
'@rolldown/binding-linux-x64-musl@1.0.0-rc.12':
|
||||||
optional: true
|
optional: true
|
||||||
|
|
||||||
'@rolldown/binding-openharmony-arm64@1.0.0-rc.10':
|
'@rolldown/binding-openharmony-arm64@1.0.0-rc.12':
|
||||||
optional: true
|
optional: true
|
||||||
|
|
||||||
'@rolldown/binding-wasm32-wasi@1.0.0-rc.10':
|
'@rolldown/binding-wasm32-wasi@1.0.0-rc.12(@emnapi/core@1.8.1)(@emnapi/runtime@1.8.1)':
|
||||||
dependencies:
|
dependencies:
|
||||||
'@napi-rs/wasm-runtime': 1.1.1
|
'@napi-rs/wasm-runtime': 1.1.2(@emnapi/core@1.8.1)(@emnapi/runtime@1.8.1)
|
||||||
|
transitivePeerDependencies:
|
||||||
|
- '@emnapi/core'
|
||||||
|
- '@emnapi/runtime'
|
||||||
optional: true
|
optional: true
|
||||||
|
|
||||||
'@rolldown/binding-win32-arm64-msvc@1.0.0-rc.10':
|
'@rolldown/binding-win32-arm64-msvc@1.0.0-rc.12':
|
||||||
optional: true
|
optional: true
|
||||||
|
|
||||||
'@rolldown/binding-win32-x64-msvc@1.0.0-rc.10':
|
'@rolldown/binding-win32-x64-msvc@1.0.0-rc.12':
|
||||||
optional: true
|
optional: true
|
||||||
|
|
||||||
'@rolldown/pluginutils@1.0.0-rc.10': {}
|
'@rolldown/pluginutils@1.0.0-rc.12': {}
|
||||||
|
|
||||||
'@rolldown/pluginutils@1.0.0-rc.7': {}
|
'@rolldown/pluginutils@1.0.0-rc.7': {}
|
||||||
|
|
||||||
@@ -2423,17 +2445,17 @@ snapshots:
|
|||||||
'@tailwindcss/oxide-win32-arm64-msvc': 4.2.2
|
'@tailwindcss/oxide-win32-arm64-msvc': 4.2.2
|
||||||
'@tailwindcss/oxide-win32-x64-msvc': 4.2.2
|
'@tailwindcss/oxide-win32-x64-msvc': 4.2.2
|
||||||
|
|
||||||
'@tailwindcss/vite@4.2.2(vite@8.0.1(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3))':
|
'@tailwindcss/vite@4.2.2(vite@8.0.5(@emnapi/core@1.8.1)(@emnapi/runtime@1.8.1)(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3))':
|
||||||
dependencies:
|
dependencies:
|
||||||
'@tailwindcss/node': 4.2.2
|
'@tailwindcss/node': 4.2.2
|
||||||
'@tailwindcss/oxide': 4.2.2
|
'@tailwindcss/oxide': 4.2.2
|
||||||
tailwindcss: 4.2.2
|
tailwindcss: 4.2.2
|
||||||
vite: 8.0.1(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3)
|
vite: 8.0.5(@emnapi/core@1.8.1)(@emnapi/runtime@1.8.1)(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3)
|
||||||
|
|
||||||
'@testing-library/dom@10.4.1':
|
'@testing-library/dom@10.4.1':
|
||||||
dependencies:
|
dependencies:
|
||||||
'@babel/code-frame': 7.29.0
|
'@babel/code-frame': 7.29.0
|
||||||
'@babel/runtime': 7.28.6
|
'@babel/runtime': 7.29.2
|
||||||
'@types/aria-query': 5.0.4
|
'@types/aria-query': 5.0.4
|
||||||
aria-query: 5.3.0
|
aria-query: 5.3.0
|
||||||
dom-accessibility-api: 0.5.16
|
dom-accessibility-api: 0.5.16
|
||||||
@@ -2494,12 +2516,12 @@ snapshots:
|
|||||||
|
|
||||||
'@types/sarif@2.1.7': {}
|
'@types/sarif@2.1.7': {}
|
||||||
|
|
||||||
'@vitejs/plugin-react@6.0.1(vite@8.0.1(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3))':
|
'@vitejs/plugin-react@6.0.1(vite@8.0.5(@emnapi/core@1.8.1)(@emnapi/runtime@1.8.1)(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3))':
|
||||||
dependencies:
|
dependencies:
|
||||||
'@rolldown/pluginutils': 1.0.0-rc.7
|
'@rolldown/pluginutils': 1.0.0-rc.7
|
||||||
vite: 8.0.1(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3)
|
vite: 8.0.5(@emnapi/core@1.8.1)(@emnapi/runtime@1.8.1)(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3)
|
||||||
|
|
||||||
'@vitest/coverage-v8@4.1.0(vitest@4.1.0(@types/node@25.3.3)(jsdom@29.0.1)(vite@8.0.1(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3)))':
|
'@vitest/coverage-v8@4.1.0(vitest@4.1.0(@types/node@25.3.3)(jsdom@29.0.1)(vite@8.0.5(@emnapi/core@1.8.1)(@emnapi/runtime@1.8.1)(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3)))':
|
||||||
dependencies:
|
dependencies:
|
||||||
'@bcoe/v8-coverage': 1.0.2
|
'@bcoe/v8-coverage': 1.0.2
|
||||||
'@vitest/utils': 4.1.0
|
'@vitest/utils': 4.1.0
|
||||||
@@ -2511,7 +2533,7 @@ snapshots:
|
|||||||
obug: 2.1.1
|
obug: 2.1.1
|
||||||
std-env: 4.0.0
|
std-env: 4.0.0
|
||||||
tinyrainbow: 3.1.0
|
tinyrainbow: 3.1.0
|
||||||
vitest: 4.1.0(@types/node@25.3.3)(jsdom@29.0.1)(vite@8.0.1(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3))
|
vitest: 4.1.0(@types/node@25.3.3)(jsdom@29.0.1)(vite@8.0.5(@emnapi/core@1.8.1)(@emnapi/runtime@1.8.1)(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3))
|
||||||
|
|
||||||
'@vitest/expect@4.1.0':
|
'@vitest/expect@4.1.0':
|
||||||
dependencies:
|
dependencies:
|
||||||
@@ -2522,13 +2544,13 @@ snapshots:
|
|||||||
chai: 6.2.2
|
chai: 6.2.2
|
||||||
tinyrainbow: 3.1.0
|
tinyrainbow: 3.1.0
|
||||||
|
|
||||||
'@vitest/mocker@4.1.0(vite@8.0.1(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3))':
|
'@vitest/mocker@4.1.0(vite@8.0.5(@emnapi/core@1.8.1)(@emnapi/runtime@1.8.1)(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3))':
|
||||||
dependencies:
|
dependencies:
|
||||||
'@vitest/spy': 4.1.0
|
'@vitest/spy': 4.1.0
|
||||||
estree-walker: 3.0.3
|
estree-walker: 3.0.3
|
||||||
magic-string: 0.30.21
|
magic-string: 0.30.21
|
||||||
optionalDependencies:
|
optionalDependencies:
|
||||||
vite: 8.0.1(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3)
|
vite: 8.0.5(@emnapi/core@1.8.1)(@emnapi/runtime@1.8.1)(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3)
|
||||||
|
|
||||||
'@vitest/pretty-format@4.1.0':
|
'@vitest/pretty-format@4.1.0':
|
||||||
dependencies:
|
dependencies:
|
||||||
@@ -3330,26 +3352,29 @@ snapshots:
|
|||||||
|
|
||||||
reusify@1.1.0: {}
|
reusify@1.1.0: {}
|
||||||
|
|
||||||
rolldown@1.0.0-rc.10:
|
rolldown@1.0.0-rc.12(@emnapi/core@1.8.1)(@emnapi/runtime@1.8.1):
|
||||||
dependencies:
|
dependencies:
|
||||||
'@oxc-project/types': 0.120.0
|
'@oxc-project/types': 0.122.0
|
||||||
'@rolldown/pluginutils': 1.0.0-rc.10
|
'@rolldown/pluginutils': 1.0.0-rc.12
|
||||||
optionalDependencies:
|
optionalDependencies:
|
||||||
'@rolldown/binding-android-arm64': 1.0.0-rc.10
|
'@rolldown/binding-android-arm64': 1.0.0-rc.12
|
||||||
'@rolldown/binding-darwin-arm64': 1.0.0-rc.10
|
'@rolldown/binding-darwin-arm64': 1.0.0-rc.12
|
||||||
'@rolldown/binding-darwin-x64': 1.0.0-rc.10
|
'@rolldown/binding-darwin-x64': 1.0.0-rc.12
|
||||||
'@rolldown/binding-freebsd-x64': 1.0.0-rc.10
|
'@rolldown/binding-freebsd-x64': 1.0.0-rc.12
|
||||||
'@rolldown/binding-linux-arm-gnueabihf': 1.0.0-rc.10
|
'@rolldown/binding-linux-arm-gnueabihf': 1.0.0-rc.12
|
||||||
'@rolldown/binding-linux-arm64-gnu': 1.0.0-rc.10
|
'@rolldown/binding-linux-arm64-gnu': 1.0.0-rc.12
|
||||||
'@rolldown/binding-linux-arm64-musl': 1.0.0-rc.10
|
'@rolldown/binding-linux-arm64-musl': 1.0.0-rc.12
|
||||||
'@rolldown/binding-linux-ppc64-gnu': 1.0.0-rc.10
|
'@rolldown/binding-linux-ppc64-gnu': 1.0.0-rc.12
|
||||||
'@rolldown/binding-linux-s390x-gnu': 1.0.0-rc.10
|
'@rolldown/binding-linux-s390x-gnu': 1.0.0-rc.12
|
||||||
'@rolldown/binding-linux-x64-gnu': 1.0.0-rc.10
|
'@rolldown/binding-linux-x64-gnu': 1.0.0-rc.12
|
||||||
'@rolldown/binding-linux-x64-musl': 1.0.0-rc.10
|
'@rolldown/binding-linux-x64-musl': 1.0.0-rc.12
|
||||||
'@rolldown/binding-openharmony-arm64': 1.0.0-rc.10
|
'@rolldown/binding-openharmony-arm64': 1.0.0-rc.12
|
||||||
'@rolldown/binding-wasm32-wasi': 1.0.0-rc.10
|
'@rolldown/binding-wasm32-wasi': 1.0.0-rc.12(@emnapi/core@1.8.1)(@emnapi/runtime@1.8.1)
|
||||||
'@rolldown/binding-win32-arm64-msvc': 1.0.0-rc.10
|
'@rolldown/binding-win32-arm64-msvc': 1.0.0-rc.12
|
||||||
'@rolldown/binding-win32-x64-msvc': 1.0.0-rc.10
|
'@rolldown/binding-win32-x64-msvc': 1.0.0-rc.12
|
||||||
|
transitivePeerDependencies:
|
||||||
|
- '@emnapi/core'
|
||||||
|
- '@emnapi/runtime'
|
||||||
|
|
||||||
run-parallel@1.2.0:
|
run-parallel@1.2.0:
|
||||||
dependencies:
|
dependencies:
|
||||||
@@ -3467,23 +3492,26 @@ snapshots:
|
|||||||
|
|
||||||
universalify@2.0.1: {}
|
universalify@2.0.1: {}
|
||||||
|
|
||||||
vite@8.0.1(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3):
|
vite@8.0.5(@emnapi/core@1.8.1)(@emnapi/runtime@1.8.1)(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3):
|
||||||
dependencies:
|
dependencies:
|
||||||
lightningcss: 1.32.0
|
lightningcss: 1.32.0
|
||||||
picomatch: 4.0.4
|
picomatch: 4.0.4
|
||||||
postcss: 8.5.8
|
postcss: 8.5.8
|
||||||
rolldown: 1.0.0-rc.10
|
rolldown: 1.0.0-rc.12(@emnapi/core@1.8.1)(@emnapi/runtime@1.8.1)
|
||||||
tinyglobby: 0.2.15
|
tinyglobby: 0.2.15
|
||||||
optionalDependencies:
|
optionalDependencies:
|
||||||
'@types/node': 25.3.3
|
'@types/node': 25.3.3
|
||||||
fsevents: 2.3.3
|
fsevents: 2.3.3
|
||||||
jiti: 2.6.1
|
jiti: 2.6.1
|
||||||
yaml: 2.8.3
|
yaml: 2.8.3
|
||||||
|
transitivePeerDependencies:
|
||||||
|
- '@emnapi/core'
|
||||||
|
- '@emnapi/runtime'
|
||||||
|
|
||||||
vitest@4.1.0(@types/node@25.3.3)(jsdom@29.0.1)(vite@8.0.1(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3)):
|
vitest@4.1.0(@types/node@25.3.3)(jsdom@29.0.1)(vite@8.0.5(@emnapi/core@1.8.1)(@emnapi/runtime@1.8.1)(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3)):
|
||||||
dependencies:
|
dependencies:
|
||||||
'@vitest/expect': 4.1.0
|
'@vitest/expect': 4.1.0
|
||||||
'@vitest/mocker': 4.1.0(vite@8.0.1(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3))
|
'@vitest/mocker': 4.1.0(vite@8.0.5(@emnapi/core@1.8.1)(@emnapi/runtime@1.8.1)(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3))
|
||||||
'@vitest/pretty-format': 4.1.0
|
'@vitest/pretty-format': 4.1.0
|
||||||
'@vitest/runner': 4.1.0
|
'@vitest/runner': 4.1.0
|
||||||
'@vitest/snapshot': 4.1.0
|
'@vitest/snapshot': 4.1.0
|
||||||
@@ -3500,7 +3528,7 @@ snapshots:
|
|||||||
tinyexec: 1.0.4
|
tinyexec: 1.0.4
|
||||||
tinyglobby: 0.2.15
|
tinyglobby: 0.2.15
|
||||||
tinyrainbow: 3.1.0
|
tinyrainbow: 3.1.0
|
||||||
vite: 8.0.1(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3)
|
vite: 8.0.5(@emnapi/core@1.8.1)(@emnapi/runtime@1.8.1)(@types/node@25.3.3)(jiti@2.6.1)(yaml@2.8.3)
|
||||||
why-is-node-running: 2.3.0
|
why-is-node-running: 2.3.0
|
||||||
optionalDependencies:
|
optionalDependencies:
|
||||||
'@types/node': 25.3.3
|
'@types/node': 25.3.3
|
||||||
|
|||||||
215
scripts/generate-pf2e-bestiary-index.mjs
Normal file
215
scripts/generate-pf2e-bestiary-index.mjs
Normal file
@@ -0,0 +1,215 @@
|
|||||||
|
import { readdirSync, readFileSync, writeFileSync } from "node:fs";
|
||||||
|
import { join } from "node:path";
|
||||||
|
|
||||||
|
// Usage: node scripts/generate-pf2e-bestiary-index.mjs <path-to-Pf2eTools>
|
||||||
|
//
|
||||||
|
// Requires a local clone/checkout of https://github.com/Pf2eToolsOrg/Pf2eTools (dev branch)
|
||||||
|
// with at least data/bestiary/.
|
||||||
|
//
|
||||||
|
// Example:
|
||||||
|
// git clone --depth 1 --branch dev --sparse https://github.com/Pf2eToolsOrg/Pf2eTools.git /tmp/pf2etools
|
||||||
|
// cd /tmp/pf2etools && git sparse-checkout set data/bestiary data
|
||||||
|
// node scripts/generate-pf2e-bestiary-index.mjs /tmp/pf2etools
|
||||||
|
|
||||||
|
const TOOLS_ROOT = process.argv[2];
|
||||||
|
if (!TOOLS_ROOT) {
|
||||||
|
console.error(
|
||||||
|
"Usage: node scripts/generate-pf2e-bestiary-index.mjs <Pf2eTools-path>",
|
||||||
|
);
|
||||||
|
process.exit(1);
|
||||||
|
}
|
||||||
|
|
||||||
|
const PROJECT_ROOT = join(import.meta.dirname, "..");
|
||||||
|
const BESTIARY_DIR = join(TOOLS_ROOT, "data/bestiary");
|
||||||
|
const OUTPUT_PATH = join(PROJECT_ROOT, "data/bestiary/pf2e-index.json");
|
||||||
|
|
||||||
|
// --- Source display names ---
|
||||||
|
// Pf2eTools doesn't have a single books.json with all adventure paths.
|
||||||
|
// We map known source codes to display names here.
|
||||||
|
const SOURCE_NAMES = {
|
||||||
|
B1: "Bestiary",
|
||||||
|
B2: "Bestiary 2",
|
||||||
|
B3: "Bestiary 3",
|
||||||
|
CRB: "Core Rulebook",
|
||||||
|
GMG: "Gamemastery Guide",
|
||||||
|
LOME: "Lost Omens: The Mwangi Expanse",
|
||||||
|
LOMM: "Lost Omens: Monsters of Myth",
|
||||||
|
LOIL: "Lost Omens: Impossible Lands",
|
||||||
|
LOCG: "Lost Omens: Character Guide",
|
||||||
|
LOSK: "Lost Omens: Knights of Lastwall",
|
||||||
|
LOTXWG: "Lost Omens: Travel Guide",
|
||||||
|
LOACLO: "Lost Omens: Absalom, City of Lost Omens",
|
||||||
|
LOHh: "Lost Omens: Highhelm",
|
||||||
|
AoA1: "Age of Ashes #1: Hellknight Hill",
|
||||||
|
AoA2: "Age of Ashes #2: Cult of Cinders",
|
||||||
|
AoA3: "Age of Ashes #3: Tomorrow Must Burn",
|
||||||
|
AoA4: "Age of Ashes #4: Fires of the Haunted City",
|
||||||
|
AoA5: "Age of Ashes #5: Against the Scarlet Triad",
|
||||||
|
AoA6: "Age of Ashes #6: Broken Promises",
|
||||||
|
AoE1: "Agents of Edgewatch #1",
|
||||||
|
AoE2: "Agents of Edgewatch #2",
|
||||||
|
AoE3: "Agents of Edgewatch #3",
|
||||||
|
AoE4: "Agents of Edgewatch #4",
|
||||||
|
AoE5: "Agents of Edgewatch #5",
|
||||||
|
AoE6: "Agents of Edgewatch #6",
|
||||||
|
EC1: "Extinction Curse #1",
|
||||||
|
EC2: "Extinction Curse #2",
|
||||||
|
EC3: "Extinction Curse #3",
|
||||||
|
EC4: "Extinction Curse #4",
|
||||||
|
EC5: "Extinction Curse #5",
|
||||||
|
EC6: "Extinction Curse #6",
|
||||||
|
AV1: "Abomination Vaults #1",
|
||||||
|
AV2: "Abomination Vaults #2",
|
||||||
|
AV3: "Abomination Vaults #3",
|
||||||
|
FRP1: "Fists of the Ruby Phoenix #1",
|
||||||
|
FRP2: "Fists of the Ruby Phoenix #2",
|
||||||
|
FRP3: "Fists of the Ruby Phoenix #3",
|
||||||
|
SoT1: "Strength of Thousands #1",
|
||||||
|
SoT2: "Strength of Thousands #2",
|
||||||
|
SoT3: "Strength of Thousands #3",
|
||||||
|
SoT4: "Strength of Thousands #4",
|
||||||
|
SoT5: "Strength of Thousands #5",
|
||||||
|
SoT6: "Strength of Thousands #6",
|
||||||
|
OoA1: "Outlaws of Alkenstar #1",
|
||||||
|
OoA2: "Outlaws of Alkenstar #2",
|
||||||
|
OoA3: "Outlaws of Alkenstar #3",
|
||||||
|
BotD: "Book of the Dead",
|
||||||
|
DA: "Dark Archive",
|
||||||
|
FoP: "The Fall of Plaguestone",
|
||||||
|
LTiBA: "Little Trouble in Big Absalom",
|
||||||
|
Sli: "The Slithering",
|
||||||
|
TiO: "Troubles in Otari",
|
||||||
|
NGD: "Night of the Gray Death",
|
||||||
|
BB: "Beginner Box",
|
||||||
|
SoG1: "Sky King's Tomb #1",
|
||||||
|
SoG2: "Sky King's Tomb #2",
|
||||||
|
SoG3: "Sky King's Tomb #3",
|
||||||
|
GW1: "Gatewalkers #1",
|
||||||
|
GW2: "Gatewalkers #2",
|
||||||
|
GW3: "Gatewalkers #3",
|
||||||
|
WoW1: "Wardens of Wildwood #1",
|
||||||
|
WoW2: "Wardens of Wildwood #2",
|
||||||
|
WoW3: "Wardens of Wildwood #3",
|
||||||
|
SF1: "Season of Ghosts #1",
|
||||||
|
SF2: "Season of Ghosts #2",
|
||||||
|
SF3: "Season of Ghosts #3",
|
||||||
|
POS1: "Pathfinder One-Shots",
|
||||||
|
AFoF: "A Fistful of Flowers",
|
||||||
|
TaL: "Threshold of Knowledge",
|
||||||
|
ToK: "Threshold of Knowledge",
|
||||||
|
DaLl: "Dinner at Lionlodge",
|
||||||
|
MotM: "Monsters of the Multiverse",
|
||||||
|
Mal: "Malevolence",
|
||||||
|
TEC: "The Enmity Cycle",
|
||||||
|
SaS: "Shadows at Sundown",
|
||||||
|
Rust: "Rusthenge",
|
||||||
|
CotT: "Crown of the Kobold King",
|
||||||
|
SoM: "Secrets of Magic",
|
||||||
|
};
|
||||||
|
|
||||||
|
// --- Size extraction from traits ---
|
||||||
|
const SIZES = new Set([
|
||||||
|
"tiny",
|
||||||
|
"small",
|
||||||
|
"medium",
|
||||||
|
"large",
|
||||||
|
"huge",
|
||||||
|
"gargantuan",
|
||||||
|
]);
|
||||||
|
|
||||||
|
// Creature type traits (PF2e types are lowercase in the traits array)
|
||||||
|
const CREATURE_TYPES = new Set([
|
||||||
|
"aberration",
|
||||||
|
"animal",
|
||||||
|
"astral",
|
||||||
|
"beast",
|
||||||
|
"celestial",
|
||||||
|
"construct",
|
||||||
|
"dragon",
|
||||||
|
"dream",
|
||||||
|
"elemental",
|
||||||
|
"ethereal",
|
||||||
|
"fey",
|
||||||
|
"fiend",
|
||||||
|
"fungus",
|
||||||
|
"giant",
|
||||||
|
"humanoid",
|
||||||
|
"monitor",
|
||||||
|
"ooze",
|
||||||
|
"petitioner",
|
||||||
|
"plant",
|
||||||
|
"spirit",
|
||||||
|
"time",
|
||||||
|
"undead",
|
||||||
|
]);
|
||||||
|
|
||||||
|
function extractSize(traits) {
|
||||||
|
if (!Array.isArray(traits)) return "medium";
|
||||||
|
const found = traits.find((t) => SIZES.has(t.toLowerCase()));
|
||||||
|
return found ? found.toLowerCase() : "medium";
|
||||||
|
}
|
||||||
|
|
||||||
|
function extractType(traits) {
|
||||||
|
if (!Array.isArray(traits)) return "";
|
||||||
|
const found = traits.find((t) => CREATURE_TYPES.has(t.toLowerCase()));
|
||||||
|
return found ? found.toLowerCase() : "";
|
||||||
|
}
|
||||||
|
|
||||||
|
// --- Main ---
|
||||||
|
|
||||||
|
const files = readdirSync(BESTIARY_DIR).filter(
|
||||||
|
(f) => f.startsWith("creatures-") && f.endsWith(".json"),
|
||||||
|
);
|
||||||
|
|
||||||
|
const creatures = [];
|
||||||
|
const seenSources = new Set();
|
||||||
|
|
||||||
|
for (const file of files.sort()) {
|
||||||
|
const raw = JSON.parse(readFileSync(join(BESTIARY_DIR, file), "utf-8"));
|
||||||
|
const entries = raw.creature ?? [];
|
||||||
|
|
||||||
|
for (const c of entries) {
|
||||||
|
// Skip copies/references
|
||||||
|
if (c._copy) continue;
|
||||||
|
|
||||||
|
const source = c.source ?? "";
|
||||||
|
seenSources.add(source);
|
||||||
|
|
||||||
|
const ac = c.defenses?.ac?.std ?? 0;
|
||||||
|
const hp = c.defenses?.hp?.[0]?.hp ?? 0;
|
||||||
|
const perception = c.perception?.std ?? 0;
|
||||||
|
|
||||||
|
creatures.push({
|
||||||
|
n: c.name,
|
||||||
|
s: source,
|
||||||
|
lv: c.level ?? 0,
|
||||||
|
ac,
|
||||||
|
hp,
|
||||||
|
pc: perception,
|
||||||
|
sz: extractSize(c.traits),
|
||||||
|
tp: extractType(c.traits),
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Sort by name then source for stable output
|
||||||
|
creatures.sort((a, b) => a.n.localeCompare(b.n) || a.s.localeCompare(b.s));
|
||||||
|
|
||||||
|
// Build source map from seen sources
|
||||||
|
const sources = {};
|
||||||
|
for (const code of [...seenSources].sort()) {
|
||||||
|
sources[code] = SOURCE_NAMES[code] ?? code;
|
||||||
|
}
|
||||||
|
|
||||||
|
const output = { sources, creatures };
|
||||||
|
writeFileSync(OUTPUT_PATH, JSON.stringify(output));
|
||||||
|
|
||||||
|
const rawSize = Buffer.byteLength(JSON.stringify(output));
|
||||||
|
console.log(`Sources: ${Object.keys(sources).length}`);
|
||||||
|
console.log(`Creatures: ${creatures.length}`);
|
||||||
|
console.log(`Output size: ${(rawSize / 1024).toFixed(1)} KB`);
|
||||||
|
|
||||||
|
const unmapped = [...seenSources].filter((s) => !SOURCE_NAMES[s]);
|
||||||
|
if (unmapped.length > 0) {
|
||||||
|
console.log(`Unmapped sources: ${unmapped.sort().join(", ")}`);
|
||||||
|
}
|
||||||
@@ -23,10 +23,15 @@ interface Combatant {
|
|||||||
readonly currentHp?: number; // 0..maxHp
|
readonly currentHp?: number; // 0..maxHp
|
||||||
readonly tempHp?: number; // positive integer, damage buffer
|
readonly tempHp?: number; // positive integer, damage buffer
|
||||||
readonly ac?: number; // non-negative integer
|
readonly ac?: number; // non-negative integer
|
||||||
readonly conditions?: readonly ConditionId[];
|
readonly conditions?: readonly ConditionEntry[];
|
||||||
readonly isConcentrating?: boolean;
|
readonly isConcentrating?: boolean;
|
||||||
readonly creatureId?: CreatureId; // link to bestiary entry
|
readonly creatureId?: CreatureId; // link to bestiary entry
|
||||||
}
|
}
|
||||||
|
|
||||||
|
interface ConditionEntry {
|
||||||
|
readonly id: ConditionId;
|
||||||
|
readonly value?: number; // PF2e valued conditions (e.g., Clumsy 2); undefined for D&D
|
||||||
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
@@ -273,21 +278,41 @@ Acceptance scenarios:
|
|||||||
3. **Given** a combatant is NOT concentrating, **When** damage is taken, **Then** no pulse/flash occurs.
|
3. **Given** a combatant is NOT concentrating, **When** damage is taken, **Then** no pulse/flash occurs.
|
||||||
4. **Given** a concentrating combatant takes damage, **When** the animation completes, **Then** the row returns to its normal concentration-active appearance.
|
4. **Given** a concentrating combatant takes damage, **When** the animation completes, **Then** the row returns to its normal concentration-active appearance.
|
||||||
|
|
||||||
**Story CC-8 — Rules Edition Setting (P2)**
|
**Story CC-8 — Game System Setting (P2)**
|
||||||
As a DM who plays in both 5e (2014) and 5.5e (2024) groups, I want to choose which edition's condition descriptions appear in tooltips so I reference the correct rules for the game I am running.
|
As a DM who runs games across D&D 5e, 5.5e, and Pathfinder 2e, I want to choose which game system the tracker uses so that conditions, bestiary search, stat block layout, and initiative calculation all match the game I am running.
|
||||||
|
|
||||||
Acceptance scenarios:
|
Acceptance scenarios:
|
||||||
1. **Given** the user opens the kebab menu, **When** they click "Settings", **Then** a settings modal opens.
|
1. **Given** the user opens the kebab menu, **When** they click "Settings", **Then** a settings modal opens.
|
||||||
2. **Given** the settings modal is open, **When** viewing the Conditions section, **Then** a rules edition selector shows 5e (2014) and 5.5e (2024) with 5.5e selected by default.
|
2. **Given** the settings modal is open, **When** viewing the Game System section, **Then** a selector shows three options: D&D 5e (2014), D&D 5.5e (2024), and Pathfinder 2e, with D&D 5.5e selected by default.
|
||||||
3. **Given** the user selects 5e (2014), **When** hovering a condition icon (e.g., Exhaustion), **Then** the tooltip shows the 2014 description.
|
3. **Given** the user selects Pathfinder 2e, **When** viewing condition icons/tooltips, **Then** the PF2e condition set is used (Clumsy, Drained, Enfeebled, etc.) instead of D&D conditions.
|
||||||
4. **Given** the user selects 5.5e (2024), **When** hovering the same condition, **Then** the tooltip shows the 2024 description.
|
4. **Given** the user selects Pathfinder 2e, **When** searching creatures in the bestiary, **Then** results come from the PF2e index (~2,700+ creatures) instead of the D&D index.
|
||||||
5. **Given** the user changes the edition and reloads the page, **Then** the selected edition is preserved.
|
5. **Given** the user selects Pathfinder 2e, **When** viewing a creature stat block, **Then** the PF2e layout is shown (level, Fort/Ref/Will, ability modifiers, top/mid/bot ability sections).
|
||||||
6. **Given** a condition with identical rules across editions (e.g., Deafened), **Then** the tooltip text is the same regardless of setting.
|
6. **Given** the user selects Pathfinder 2e, **When** rolling initiative for a bestiary creature, **Then** Perception is used as the initiative modifier instead of DEX + proficiency.
|
||||||
7. **Given** the settings modal is open, **When** viewing the Theme section, **Then** a System / Light / Dark selector is available, replacing the inline cycle button in the kebab menu.
|
7. **Given** the user selects D&D 5e (2014), **When** hovering a condition icon (e.g., Exhaustion), **Then** the tooltip shows the 2014 description. **When** 5.5e (2024) is selected, **Then** the tooltip shows the 2024 description.
|
||||||
|
8. **Given** the user changes the game system and reloads the page, **Then** the selected game system is preserved.
|
||||||
|
9. **Given** a condition with identical rules across D&D editions (e.g., Deafened), **Then** the tooltip text is the same regardless of D&D edition.
|
||||||
|
10. **Given** the settings modal is open, **When** viewing the Theme section, **Then** a System / Light / Dark selector is available, replacing the inline cycle button in the kebab menu.
|
||||||
|
|
||||||
|
**Story CC-9 — Value-Based Conditions (P2)**
|
||||||
|
As a DM running a PF2e encounter, I want conditions like Clumsy, Frightened, and Drained to carry an integer value so I can track escalating severity levels as defined by the PF2e rules.
|
||||||
|
|
||||||
|
The condition picker uses the same counter pattern as the bestiary batch-add (see `specs/004-bestiary/spec.md`, US-S2): clicking a valued condition shows `[-] N [+] [✓]` controls inline; the user adjusts the value and confirms. Clicking a condition tag on the combatant row decrements the value by 1.
|
||||||
|
|
||||||
|
Acceptance scenarios:
|
||||||
|
1. **Given** the game system is Pathfinder 2e and the condition picker is open, **When** the user clicks an inactive valued condition (e.g., Frightened), **Then** the row shows a counter at value 1 with `[-]`, `[+]`, and `[✓]` (confirm) buttons — the condition is not yet applied.
|
||||||
|
2. **Given** the counter is showing value 1, **When** the user clicks `[+]` twice, **Then** the counter shows value 3.
|
||||||
|
3. **Given** the counter is showing a value, **When** the user clicks `[✓]` (confirm), **Then** the condition is applied at that value and its icon appears inline with the value as a badge.
|
||||||
|
4. **Given** a combatant already has Frightened 2 and the picker is open, **When** the user clicks Frightened in the picker, **Then** the counter shows pre-filled at value 2 for adjustment.
|
||||||
|
5. **Given** a combatant has Frightened 2, **When** the user clicks the Frightened icon tag on the row, **Then** the value decrements to 1.
|
||||||
|
6. **Given** a combatant has Frightened 1, **When** the user clicks the Frightened icon tag on the row, **Then** the condition is removed entirely.
|
||||||
|
7. **Given** a PF2e condition that is not valued (e.g., Prone, Off-Guard), **When** the user clicks it in the picker, **Then** it toggles on/off with no counter or value badge — identical to D&D condition behavior.
|
||||||
|
8. **Given** the game system is D&D (5e or 5.5e), **When** interacting with conditions, **Then** no value counters or badges are shown and conditions toggle on/off as before.
|
||||||
|
9. **Given** a combatant has Clumsy 3, **When** the user hovers over the condition icon, **Then** the tooltip shows the condition name, the current value, and the PF2e rules description.
|
||||||
|
10. **Given** a valued condition counter is showing, **When** the user clicks a different valued condition, **Then** the previous counter is replaced (only one counter at a time).
|
||||||
|
|
||||||
### Requirements
|
### Requirements
|
||||||
|
|
||||||
- **FR-032**: The MVP MUST support the following 15 standard D&D 5e/5.5e conditions: blinded, charmed, deafened, exhaustion, frightened, grappled, incapacitated, invisible, paralyzed, petrified, poisoned, prone, restrained, stunned, unconscious.
|
- **FR-032**: When a D&D game system is active, the system MUST support the following 15 standard D&D 5e/5.5e conditions: blinded, charmed, deafened, exhaustion, frightened, grappled, incapacitated, invisible, paralyzed, petrified, poisoned, prone, restrained, stunned, unconscious. When Pathfinder 2e is active, the system MUST support the PF2e condition set (see FR-103).
|
||||||
- **FR-033**: Each condition MUST have a fixed icon and color mapping (Lucide icons; no emoji):
|
- **FR-033**: Each condition MUST have a fixed icon and color mapping (Lucide icons; no emoji):
|
||||||
|
|
||||||
| Condition | Icon | Color |
|
| Condition | Icon | Color |
|
||||||
@@ -312,9 +337,9 @@ Acceptance scenarios:
|
|||||||
- **FR-035**: Conditions MUST be displayed in the fixed definition order (blinded -> unconscious), regardless of application order.
|
- **FR-035**: Conditions MUST be displayed in the fixed definition order (blinded -> unconscious), regardless of application order.
|
||||||
- **FR-036**: The "+" condition button MUST be hidden by default and appear only on row hover (or touch/focus on touch devices).
|
- **FR-036**: The "+" condition button MUST be hidden by default and appear only on row hover (or touch/focus on touch devices).
|
||||||
- **FR-037**: Clicking "+" MUST open the compact condition picker showing all conditions as icon + label pairs.
|
- **FR-037**: Clicking "+" MUST open the compact condition picker showing all conditions as icon + label pairs.
|
||||||
- **FR-038**: Clicking a condition in the picker MUST toggle it on or off.
|
- **FR-038**: Clicking a condition in the picker MUST toggle it on or off. For PF2e valued conditions, clicking MUST open an inline counter (same pattern as the bestiary batch-add count badge: `[-] N [+] [✓]`) instead of toggling immediately. The user adjusts the value and confirms with the `[✓]` button. Only one valued condition counter may be open at a time.
|
||||||
- **FR-039**: Clicking an active condition icon tag in the row MUST remove that condition.
|
- **FR-039**: For D&D conditions, clicking an active condition icon tag in the row MUST remove that condition. For PF2e valued conditions, clicking MUST decrement the value by 1; the condition is removed when the value reaches 0. For PF2e non-valued conditions, clicking removes the condition.
|
||||||
- **FR-040**: Hovering an active condition icon MUST show a tooltip with the condition name and its rules description for the selected edition.
|
- **FR-040**: Hovering an active condition icon MUST show a tooltip with the condition name and its rules description for the active game system. For PF2e valued conditions, the tooltip MUST also display the current value (e.g., "Frightened 2").
|
||||||
- **FR-041**: Condition icons MUST NOT increase the row's width; row height MAY increase to accommodate wrapping.
|
- **FR-041**: Condition icons MUST NOT increase the row's width; row height MAY increase to accommodate wrapping.
|
||||||
- **FR-042**: The condition picker MUST close when the user clicks outside of it.
|
- **FR-042**: The condition picker MUST close when the user clicks outside of it.
|
||||||
- **FR-043**: Conditions MUST persist as part of combatant state (surviving page reload).
|
- **FR-043**: Conditions MUST persist as part of combatant state (surviving page reload).
|
||||||
@@ -330,6 +355,11 @@ Acceptance scenarios:
|
|||||||
- **FR-053**: When a concentrating combatant takes damage, the Brain icon and row accent MUST briefly pulse/flash for 700 ms.
|
- **FR-053**: When a concentrating combatant takes damage, the Brain icon and row accent MUST briefly pulse/flash for 700 ms.
|
||||||
- **FR-054**: The pulse animation MUST NOT trigger on healing or when concentration is inactive.
|
- **FR-054**: The pulse animation MUST NOT trigger on healing or when concentration is inactive.
|
||||||
- **FR-055**: Concentration MUST persist across page reloads via existing storage.
|
- **FR-055**: Concentration MUST persist across page reloads via existing storage.
|
||||||
|
- **FR-103**: When Pathfinder 2e is active, the system MUST support the following PF2e conditions: blinded, clumsy (valued), concealed, confused, controlled, dazzled, deafened, doomed (valued), drained (valued), dying (valued), enfeebled (valued), fascinated, fatigued, fleeing, frightened (valued), grabbed, hidden, immobilized, off-guard, paralyzed, petrified, prone, quickened, restrained, sickened (valued), slowed (valued), stunned (valued), stupefied (valued), unconscious, undetected, wounded (valued).
|
||||||
|
- **FR-104**: Each PF2e condition MUST have a fixed icon and color mapping (Lucide icons; no emoji). The icon/color table for PF2e conditions is defined separately from the D&D table (FR-033).
|
||||||
|
- **FR-105**: For PF2e valued conditions, the condition icon tag MUST display the current value as a small numeric badge (e.g., "2" next to the Frightened icon). Non-valued PF2e conditions display without a badge.
|
||||||
|
- **FR-106**: The condition data model MUST use `ConditionEntry` objects (`{ id: ConditionId, value?: number }`) instead of bare `ConditionId` values. D&D conditions MUST be stored without a `value` field (backwards-compatible).
|
||||||
|
- **FR-107**: Switching the game system MUST NOT clear existing combatant conditions. Conditions from the previous game system that are not valid in the new system remain stored but are hidden from display until the user switches back.
|
||||||
|
|
||||||
### Edge Cases
|
### Edge Cases
|
||||||
|
|
||||||
@@ -340,9 +370,13 @@ Acceptance scenarios:
|
|||||||
- When concentration is toggled during an active pulse animation, the animation cancels and the new state applies immediately.
|
- When concentration is toggled during an active pulse animation, the animation cancels and the new state applies immediately.
|
||||||
- Multiple combatants may concentrate simultaneously; concentration is independent per combatant.
|
- Multiple combatants may concentrate simultaneously; concentration is independent per combatant.
|
||||||
- Conditions have no mechanical effects in the MVP baseline (no auto-disadvantage, no automation).
|
- Conditions have no mechanical effects in the MVP baseline (no auto-disadvantage, no automation).
|
||||||
- When the rules edition preference is missing from localStorage, the system defaults to 5.5e (2024).
|
- When the game system preference is missing from localStorage, the system defaults to D&D 5.5e (2024).
|
||||||
- Changing the edition while a condition tooltip is visible updates the tooltip on next hover (no live update required).
|
- Changing the game system while a condition tooltip is visible updates the tooltip on next hover (no live update required).
|
||||||
- The settings modal is app-level UI; it does not interact with encounter state.
|
- The settings modal is app-level UI; it does not interact with encounter state.
|
||||||
|
- When the game system is switched from D&D to PF2e, existing D&D conditions on combatants are hidden (not deleted). Switching back to D&D restores them.
|
||||||
|
- PF2e valued condition at value 0 is treated as removed — it MUST NOT appear on the row.
|
||||||
|
- Dying 4 in PF2e has special mechanical significance (death), but the system does not enforce this automatically — it displays the value only.
|
||||||
|
- Persistent damage is excluded from the PF2e MVP condition set. It can be added as a follow-up feature.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -410,12 +444,12 @@ Acceptance scenarios:
|
|||||||
- **FR-066**: System MUST display a d20 icon button in the initiative slot for every combatant that has a linked bestiary creature and does not yet have an initiative value.
|
- **FR-066**: System MUST display a d20 icon button in the initiative slot for every combatant that has a linked bestiary creature and does not yet have an initiative value.
|
||||||
- **FR-067**: System MUST NOT display the d20 button for combatants without a linked bestiary creature; they see a "--" placeholder that is clickable to type a value.
|
- **FR-067**: System MUST NOT display the d20 button for combatants without a linked bestiary creature; they see a "--" placeholder that is clickable to type a value.
|
||||||
- **FR-068**: When the d20 button is clicked, the system MUST generate a uniform random integer in [1, 20], add the creature's initiative modifier, and set the result as the initiative value.
|
- **FR-068**: When the d20 button is clicked, the system MUST generate a uniform random integer in [1, 20], add the creature's initiative modifier, and set the result as the initiative value.
|
||||||
- **FR-069**: The initiative modifier MUST be calculated as: DEX modifier + (proficiency multiplier x proficiency bonus), where DEX modifier = floor((DEX - 10) / 2) and proficiency bonus is derived from challenge rating.
|
- **FR-069**: For D&D creatures, the initiative modifier MUST be calculated as: DEX modifier + (proficiency multiplier x proficiency bonus), where DEX modifier = floor((DEX - 10) / 2) and proficiency bonus is derived from challenge rating. For PF2e creatures, the initiative modifier MUST be the creature's Perception value from the index.
|
||||||
- **FR-070**: The initiative proficiency multiplier MUST be read from `initiative.proficiency` in bestiary data (0 if absent, 1 for proficiency, 2 for expertise).
|
- **FR-070**: The initiative proficiency multiplier MUST be read from `initiative.proficiency` in bestiary data (0 if absent, 1 for proficiency, 2 for expertise).
|
||||||
- **FR-071**: System MUST provide a "Roll All Initiative" button in the top bar. Clicking it MUST roll for every bestiary-linked combatant that does not already have an initiative value; all others MUST be left unchanged.
|
- **FR-071**: System MUST provide a "Roll All Initiative" button in the top bar. Clicking it MUST roll for every bestiary-linked combatant that does not already have an initiative value; all others MUST be left unchanged.
|
||||||
- **FR-072**: After any initiative roll (single or batch), the encounter list MUST re-sort descending per existing behavior.
|
- **FR-072**: After any initiative roll (single or batch), the encounter list MUST re-sort descending per existing behavior.
|
||||||
- **FR-073**: Once a combatant has an initiative value, the d20 button is replaced by the value as plain text using a click-to-edit pattern (consistent with AC and name editing).
|
- **FR-073**: Once a combatant has an initiative value, the d20 button is replaced by the value as plain text using a click-to-edit pattern (consistent with AC and name editing).
|
||||||
- **FR-074**: The stat block header MUST display initiative in the format "Initiative +X (Y)" where X is the modifier (with + or - sign) and Y = 10 + X.
|
- **FR-074**: For D&D creatures, the stat block header MUST display initiative in the format "Initiative +X (Y)" where X is the modifier (with + or - sign) and Y = 10 + X. For PF2e creatures, the stat block MUST display "Perception +X" where X is the Perception modifier.
|
||||||
- **FR-075**: The initiative display in the stat block MUST be positioned adjacent to the AC value, matching Monster Manual 2024 layout.
|
- **FR-075**: The initiative display in the stat block MUST be positioned adjacent to the AC value, matching Monster Manual 2024 layout.
|
||||||
- **FR-076**: No initiative line MUST be shown in the stat block for combatants without bestiary data.
|
- **FR-076**: No initiative line MUST be shown in the stat block for combatants without bestiary data.
|
||||||
- **FR-077**: The initiative display in the stat block is display-only. It MUST NOT modify encounter turn order or trigger rolling automatically.
|
- **FR-077**: The initiative display in the stat block is display-only. It MUST NOT modify encounter turn order or trigger rolling automatically.
|
||||||
@@ -489,11 +523,11 @@ Acceptance scenarios:
|
|||||||
- **FR-093**: All interactive elements in the row MUST remain keyboard-accessible (focusable and operable via keyboard).
|
- **FR-093**: All interactive elements in the row MUST remain keyboard-accessible (focusable and operable via keyboard).
|
||||||
- **FR-094**: On touch devices, hover-only controls ("+" button, "x" button) MUST remain accessible via tap or focus.
|
- **FR-094**: On touch devices, hover-only controls ("+" button, "x" button) MUST remain accessible via tap or focus.
|
||||||
- **FR-095**: The system MUST provide a settings modal accessible via a "Settings" item in the kebab overflow menu.
|
- **FR-095**: The system MUST provide a settings modal accessible via a "Settings" item in the kebab overflow menu.
|
||||||
- **FR-096**: The settings modal MUST include a Conditions section with a rules edition selector offering two options: 5e (2014) and 5.5e (2024).
|
- **FR-096**: The settings modal MUST include a Game System section with a selector offering three options: D&D 5e (2014), D&D 5.5e (2024), and Pathfinder 2e. The label MUST read "Game System" (not "Conditions" or "Rules Edition").
|
||||||
- **FR-097**: The default rules edition MUST be 5.5e (2024).
|
- **FR-097**: The default game system MUST be D&D 5.5e (2024).
|
||||||
- **FR-098**: Each condition definition MUST carry a description for both editions. Conditions with identical rules across editions MAY share a single description value.
|
- **FR-098**: Each D&D condition definition MUST carry a description for both D&D editions. Each PF2e condition definition MUST carry a PF2e rules description. Conditions with identical rules across D&D editions MAY share a single description value.
|
||||||
- **FR-099**: Condition tooltips MUST display the description corresponding to the active rules edition preference.
|
- **FR-099**: Condition tooltips MUST display the description corresponding to the active game system. For D&D game systems, the tooltip uses the edition-specific description. For PF2e, the tooltip uses the PF2e description.
|
||||||
- **FR-100**: The rules edition preference MUST persist across sessions via localStorage (key `"initiative:rules-edition"`).
|
- **FR-100**: The game system preference MUST persist across sessions via localStorage (key `"initiative:game-system"`).
|
||||||
- **FR-101**: The settings modal MUST include a Theme section with System / Light / Dark options, replacing the inline theme cycle button in the kebab menu.
|
- **FR-101**: The settings modal MUST include a Theme section with System / Light / Dark options, replacing the inline theme cycle button in the kebab menu.
|
||||||
- **FR-102**: The settings modal MUST close on Escape, click-outside, or the close button.
|
- **FR-102**: The settings modal MUST close on Escape, click-outside, or the close button.
|
||||||
|
|
||||||
@@ -539,6 +573,10 @@ Acceptance scenarios:
|
|||||||
- **SC-028**: The AC number is visually identifiable as armor class through the shield shape alone.
|
- **SC-028**: The AC number is visually identifiable as armor class through the shield shape alone.
|
||||||
- **SC-029**: No layout shift occurs when hovering/unhovering rows.
|
- **SC-029**: No layout shift occurs when hovering/unhovering rows.
|
||||||
- **SC-030**: All HP, AC, initiative, condition, and concentration interactions remain fully operable using only a keyboard.
|
- **SC-030**: All HP, AC, initiative, condition, and concentration interactions remain fully operable using only a keyboard.
|
||||||
- **SC-031**: The user can switch rules edition in 2 interactions (open settings → select edition).
|
- **SC-031**: The user can switch game system in 2 interactions (open settings → select system).
|
||||||
- **SC-032**: Condition tooltips accurately reflect the selected edition's rules text for all conditions that differ between editions.
|
- **SC-032**: Condition tooltips accurately reflect the active game system's rules text for all conditions.
|
||||||
- **SC-033**: The rules edition preference survives a full page reload.
|
- **SC-033**: The game system preference survives a full page reload.
|
||||||
|
- **SC-034**: All PF2e conditions are available and visually distinguishable by icon and color when PF2e is the active game system.
|
||||||
|
- **SC-035**: PF2e valued conditions display their current value and can be incremented/decremented within 1 click each.
|
||||||
|
- **SC-036**: Switching game system immediately changes the available conditions, bestiary search results, stat block layout, and initiative calculation — no page reload required.
|
||||||
|
- **SC-037**: The game system preference survives a full page reload.
|
||||||
|
|||||||
@@ -8,9 +8,11 @@
|
|||||||
|
|
||||||
## Overview
|
## Overview
|
||||||
|
|
||||||
The Bestiary feature provides creature search across a pre-indexed library of 3,312+ creatures from 102+ D&D sources, stat block display for full creature reference during combat, source data management via on-demand fetch or file upload, and a dual-panel UX with collapse/expand and pin capabilities. Creatures can be added individually or in batch from a search dropdown, with stats pre-filled from the index.
|
The Bestiary feature provides creature search across pre-indexed creature libraries: 3,312+ D&D creatures from 102+ sources and ~2,700+ Pathfinder 2e creatures from 79 Pf2eTools sources. The active game system setting (see `specs/003-combatant-state/spec.md`, FR-096) determines which index the search operates against. Stat block display, source management, and creature pre-fill all adapt to the active game system.
|
||||||
|
|
||||||
The architecture uses a two-tier design: a lightweight search index (`data/bestiary/index.json`) shipped with the app containing mechanical facts for all creatures, and full stat block data loaded on-demand at the source level, normalized, and cached in IndexedDB.
|
The feature also includes full creature reference via stat block display during combat, source data management via on-demand fetch or file upload, and a dual-panel UX with collapse/expand and pin capabilities. Creatures can be added individually or in batch from a search dropdown, with stats pre-filled from the index.
|
||||||
|
|
||||||
|
The architecture uses a two-tier design: lightweight search indexes shipped with the app (one per game system) containing mechanical facts for all creatures, and full stat block data loaded on-demand at the source level, normalized, and cached in IndexedDB.
|
||||||
|
|
||||||
**Structure**: This spec is organized by topic area. Each topic section contains its own user scenarios, requirements, and edge cases.
|
**Structure**: This spec is organized by topic area. Each topic section contains its own user scenarios, requirements, and edge cases.
|
||||||
|
|
||||||
@@ -37,11 +39,11 @@ When the search input has no bestiary matches (or fewer than 2 characters typed)
|
|||||||
|
|
||||||
### Requirements
|
### Requirements
|
||||||
|
|
||||||
- **FR-001**: The app MUST ship a pre-generated search index (`data/bestiary/index.json`) containing creature name, source code, AC, HP average, DEX score, CR, initiative proficiency multiplier, size code, and creature type for all indexed creatures.
|
- **FR-001**: The app MUST ship pre-generated search indexes for each supported game system. The D&D index (`data/bestiary/index.json`) MUST contain creature name, source code, AC, HP average, DEX score, CR, initiative proficiency multiplier, size code, and creature type. The PF2e index (`data/bestiary/pf2e-index.json`) MUST contain creature name, source code, AC, HP, level, Perception modifier, size, and creature type.
|
||||||
- **FR-002**: The app MUST include a source display name map translating source codes to human-readable names (e.g., "XMM" -> "Monster Manual (2025)").
|
- **FR-002**: The app MUST include a source display name map translating source codes to human-readable names (e.g., "XMM" -> "Monster Manual (2025)").
|
||||||
- **FR-003**: Search MUST operate against the full shipped index — case-insensitive substring match on creature name, minimum 2 characters, maximum 10 results, sorted alphabetically.
|
- **FR-003**: Search MUST operate against the shipped index corresponding to the active game system — case-insensitive substring match on creature name, minimum 2 characters, maximum 10 results, sorted alphabetically.
|
||||||
- **FR-004**: Search results MUST display the source display name alongside the creature name.
|
- **FR-004**: Search results MUST display the source display name alongside the creature name.
|
||||||
- **FR-005**: Adding a creature from search MUST populate name, HP, AC, and initiative data directly from the index without any network fetch.
|
- **FR-005**: Adding a creature from search MUST populate name, HP, AC, and initiative data directly from the index without any network fetch. For D&D creatures, initiative data is the DEX-based modifier. For PF2e creatures, initiative data is the Perception modifier.
|
||||||
- **FR-006**: The system MUST auto-number duplicate creature names (e.g., "Goblin 1", "Goblin 2") when multiple combatants share the same bestiary creature name. When a second copy is added, the existing combatant is renamed to include the suffix.
|
- **FR-006**: The system MUST auto-number duplicate creature names (e.g., "Goblin 1", "Goblin 2") when multiple combatants share the same bestiary creature name. When a second copy is added, the existing combatant is renamed to include the suffix.
|
||||||
- **FR-007**: Auto-numbered names MUST remain editable via the existing rename functionality.
|
- **FR-007**: Auto-numbered names MUST remain editable via the existing rename functionality.
|
||||||
- **FR-008**: Combatants added from the bestiary MUST retain a link (`creatureId`) to their creature data so the stat block can be re-opened from the tracker.
|
- **FR-008**: Combatants added from the bestiary MUST retain a link (`creatureId`) to their creature data so the stat block can be re-opened from the tracker.
|
||||||
@@ -67,6 +69,8 @@ When the search input has no bestiary matches (or fewer than 2 characters typed)
|
|||||||
10. **Given** the user types a name with no bestiary match, **When** the dropdown shows no results, **Then** optional input fields for initiative, AC, and max HP appear with visible labels.
|
10. **Given** the user types a name with no bestiary match, **When** the dropdown shows no results, **Then** optional input fields for initiative, AC, and max HP appear with visible labels.
|
||||||
11. **Given** the optional fields are visible, **When** the user leaves all optional fields empty and submits, **Then** the creature is added with only the name (no stats pre-filled).
|
11. **Given** the optional fields are visible, **When** the user leaves all optional fields empty and submits, **Then** the creature is added with only the name (no stats pre-filled).
|
||||||
12. **Given** the search input is open, **When** the user presses Escape, **Then** the search closes without adding a combatant.
|
12. **Given** the search input is open, **When** the user presses Escape, **Then** the search closes without adding a combatant.
|
||||||
|
13. **Given** the game system is Pathfinder 2e, **When** the DM types "abo" in the search field, **Then** results show PF2e creatures (e.g., "Aboleth (Bestiary 1)") from the PF2e index, not D&D creatures.
|
||||||
|
14. **Given** the game system is Pathfinder 2e, **When** the DM selects a PF2e creature, **Then** a combatant is added with name, HP, AC, and Perception as the initiative modifier.
|
||||||
|
|
||||||
### Edge Cases
|
### Edge Cases
|
||||||
|
|
||||||
@@ -97,7 +101,7 @@ As a DM using the app on different devices, I want the layout to adapt between s
|
|||||||
### Requirements
|
### Requirements
|
||||||
|
|
||||||
- **FR-016**: The system MUST display a stat block panel with full creature information when a creature is selected.
|
- **FR-016**: The system MUST display a stat block panel with full creature information when a creature is selected.
|
||||||
- **FR-017**: The stat block MUST include: name, size, type, alignment, AC (with armor source if applicable), HP (average + formula), speed, ability scores with modifiers, saving throws, skills, damage vulnerabilities, damage resistances, damage immunities, condition immunities, senses, languages, challenge rating, proficiency bonus, passive perception, traits, actions, bonus actions, reactions, spellcasting, and legendary actions.
|
- **FR-017**: For D&D creatures, the stat block MUST include: name, size, type, alignment, AC (with armor source if applicable), HP (average + formula), speed, ability scores with modifiers, saving throws, skills, damage vulnerabilities, damage resistances, damage immunities, condition immunities, senses, languages, challenge rating, proficiency bonus, passive perception, traits, actions, bonus actions, reactions, spellcasting, and legendary actions. For PF2e creatures, the stat block MUST include: name, level, traits (as tags), Perception and senses, languages, skills, ability modifiers (Str/Dex/Con/Int/Wis/Cha as modifiers, not scores), items, AC, saving throws (Fort/Ref/Will), HP (with optional immunities/resistances/weaknesses), speed, attacks, top abilities, mid abilities (reactions/auras), bot abilities (active), and spellcasting.
|
||||||
- **FR-018**: Optional stat block sections (traits, legendary actions, bonus actions, reactions, etc.) MUST be omitted entirely when the creature has none.
|
- **FR-018**: Optional stat block sections (traits, legendary actions, bonus actions, reactions, etc.) MUST be omitted entirely when the creature has none.
|
||||||
- **FR-019**: The system MUST strip bestiary markup tags (spell references, dice notation, attack tags) and render them as plain readable text (e.g., `{@spell fireball|XPHB}` -> "fireball", `{@dice 3d6}` -> "3d6").
|
- **FR-019**: The system MUST strip bestiary markup tags (spell references, dice notation, attack tags) and render them as plain readable text (e.g., `{@spell fireball|XPHB}` -> "fireball", `{@dice 3d6}` -> "3d6").
|
||||||
- **FR-020**: On wide viewports (desktop), the layout MUST be side-by-side with the encounter tracker on the left and stat block on the right.
|
- **FR-020**: On wide viewports (desktop), the layout MUST be side-by-side with the encounter tracker on the left and stat block on the right.
|
||||||
@@ -105,6 +109,12 @@ As a DM using the app on different devices, I want the layout to adapt between s
|
|||||||
- **FR-022**: The stat block panel MUST scroll independently of the encounter tracker.
|
- **FR-022**: The stat block panel MUST scroll independently of the encounter tracker.
|
||||||
- **FR-023**: When the user clicks the book icon on a different bestiary-linked combatant row, the stat block panel MUST update to show that creature's data.
|
- **FR-023**: When the user clicks the book icon on a different bestiary-linked combatant row, the stat block panel MUST update to show that creature's data.
|
||||||
- **FR-024**: The existing search/view button MUST be repurposed to open the stat block for the currently focused/selected creature in the dropdown.
|
- **FR-024**: The existing search/view button MUST be repurposed to open the stat block for the currently focused/selected creature in the dropdown.
|
||||||
|
- **FR-063**: The stat block renderer MUST select the appropriate layout (D&D or PF2e) based on the creature's game system. The creature's game system is determined by the index it was added from.
|
||||||
|
- **FR-064**: PF2e stat blocks MUST display level in place of challenge rating. Level MUST appear in the stat block header.
|
||||||
|
- **FR-065**: PF2e stat blocks MUST display three saving throws (Fortitude, Reflex, Will) instead of D&D's six ability-based saves.
|
||||||
|
- **FR-066**: PF2e stat blocks MUST display ability modifiers directly (e.g., "Str +4") rather than ability scores with derived modifiers.
|
||||||
|
- **FR-067**: PF2e stat blocks MUST organize abilities into three sections: top (above defenses), mid (reactions and auras), and bot (active abilities), matching the Pf2eTools source structure.
|
||||||
|
- **FR-068**: PF2e stat blocks MUST strip Pf2eTools markup tags (e.g., `{@damage 1d8+7}`, `{@condition frightened}`) and render them as plain readable text, using the same tag-stripping approach as D&D (FR-019).
|
||||||
- **FR-062**: Bestiary-linked combatant rows MUST display a small book icon (Lucide `BookOpen`) as the dedicated stat block trigger. The icon MUST have a tooltip ("View stat block") and an `aria-label="View stat block"` for accessibility. The book icon is the only way to manually open a stat block from the tracker — clicking the combatant name always enters inline rename mode. Non-bestiary combatant rows MUST NOT display the book icon.
|
- **FR-062**: Bestiary-linked combatant rows MUST display a small book icon (Lucide `BookOpen`) as the dedicated stat block trigger. The icon MUST have a tooltip ("View stat block") and an `aria-label="View stat block"` for accessibility. The book icon is the only way to manually open a stat block from the tracker — clicking the combatant name always enters inline rename mode. Non-bestiary combatant rows MUST NOT display the book icon.
|
||||||
|
|
||||||
### Acceptance Scenarios
|
### Acceptance Scenarios
|
||||||
@@ -119,6 +129,8 @@ As a DM using the app on different devices, I want the layout to adapt between s
|
|||||||
8. **Given** a bestiary-linked combatant row is visible, **When** the user looks at the row, **Then** a small book icon is visible as the stat block trigger with a tooltip "View stat block".
|
8. **Given** a bestiary-linked combatant row is visible, **When** the user looks at the row, **Then** a small book icon is visible as the stat block trigger with a tooltip "View stat block".
|
||||||
9. **Given** a custom (non-bestiary) combatant row is visible, **When** the user looks at the row, **Then** no book icon is displayed.
|
9. **Given** a custom (non-bestiary) combatant row is visible, **When** the user looks at the row, **Then** no book icon is displayed.
|
||||||
10. **Given** a bestiary-linked combatant row is visible, **When** the user clicks the combatant's name, **Then** inline rename mode is entered — the stat block does NOT open.
|
10. **Given** a bestiary-linked combatant row is visible, **When** the user clicks the combatant's name, **Then** inline rename mode is entered — the stat block does NOT open.
|
||||||
|
11. **Given** a PF2e creature is selected, **When** the stat block opens, **Then** it displays: name, level, traits as tags, Perception, senses, languages, skills, ability modifiers, AC, Fort/Ref/Will saves, HP, speed, attacks, abilities (top/mid/bot sections), and spellcasting (if applicable). No CR, no ability scores, no legendary actions.
|
||||||
|
12. **Given** a PF2e creature with conditional AC (e.g., "with shield raised"), **When** viewing the stat block, **Then** both the standard AC and conditional AC are shown.
|
||||||
|
|
||||||
### Edge Cases
|
### Edge Cases
|
||||||
|
|
||||||
@@ -164,7 +176,7 @@ A DM wants to see which sources are cached, find a specific source, clear a spec
|
|||||||
- **FR-034**: An import button (Lucide Import icon) in the top bar MUST open the stat block side panel with the bulk import prompt.
|
- **FR-034**: An import button (Lucide Import icon) in the top bar MUST open the stat block side panel with the bulk import prompt.
|
||||||
- **FR-035**: The bulk import prompt MUST show a descriptive text explaining the operation, including approximate data volume (~12.5 MB) and the dynamic number of sources derived from the bestiary index at runtime.
|
- **FR-035**: The bulk import prompt MUST show a descriptive text explaining the operation, including approximate data volume (~12.5 MB) and the dynamic number of sources derived from the bestiary index at runtime.
|
||||||
- **FR-036**: The system MUST pre-fill a base URL that the user can edit.
|
- **FR-036**: The system MUST pre-fill a base URL that the user can edit.
|
||||||
- **FR-037**: The system MUST construct individual fetch URLs by appending `bestiary-{sourceCode}.json` to the base URL for each source.
|
- **FR-037**: The system MUST construct individual fetch URLs by appending the appropriate filename pattern to the base URL: `bestiary-{sourceCode}.json` for D&D sources, `creatures-{sourceCode}.json` for PF2e sources (matching the Pf2eTools naming convention).
|
||||||
- **FR-038**: All fetch requests during bulk import MUST fire concurrently (browser handles connection pooling).
|
- **FR-038**: All fetch requests during bulk import MUST fire concurrently (browser handles connection pooling).
|
||||||
- **FR-039**: Already-cached sources MUST be skipped during bulk import.
|
- **FR-039**: Already-cached sources MUST be skipped during bulk import.
|
||||||
- **FR-040**: The system MUST show a text counter ("Loading sources... N/T") and progress bar during bulk import.
|
- **FR-040**: The system MUST show a text counter ("Loading sources... N/T") and progress bar during bulk import.
|
||||||
@@ -177,6 +189,10 @@ A DM wants to see which sources are cached, find a specific source, clear a spec
|
|||||||
- **FR-047**: The app MUST provide a management UI showing cached sources with a filter input for searching by display name and options to clear individual sources or all cached data.
|
- **FR-047**: The app MUST provide a management UI showing cached sources with a filter input for searching by display name and options to clear individual sources or all cached data.
|
||||||
- **FR-048**: The normalization adapter and tag-stripping utility MUST remain the canonical pipeline for all fetched and uploaded data.
|
- **FR-048**: The normalization adapter and tag-stripping utility MUST remain the canonical pipeline for all fetched and uploaded data.
|
||||||
- **FR-049**: The distributed app bundle MUST contain zero copyrighted prose content — only mechanical facts and creature names in the search index.
|
- **FR-049**: The distributed app bundle MUST contain zero copyrighted prose content — only mechanical facts and creature names in the search index.
|
||||||
|
- **FR-069**: The system MUST use a separate normalization pipeline for PF2e source data, mapping the Pf2eTools JSON structure to the PF2e creature type. Both pipelines (D&D and PF2e) MUST use the canonical tag-stripping utility.
|
||||||
|
- **FR-070**: The source cache MUST be scoped by game system. D&D and PF2e sources MUST NOT collide in IndexedDB (e.g., both may have a source code "B1" but they are different sources).
|
||||||
|
- **FR-071**: The bulk import prompt MUST adapt to the active game system: showing the correct source count, base URL (Pf2eTools for PF2e, 5etools for D&D), and approximate data volume for the active system.
|
||||||
|
- **FR-072**: The source management UI MUST show only sources for the active game system.
|
||||||
|
|
||||||
### Acceptance Scenarios
|
### Acceptance Scenarios
|
||||||
|
|
||||||
@@ -199,6 +215,8 @@ A DM wants to see which sources are cached, find a specific source, clear a spec
|
|||||||
17. **Given** the source management UI is open, **When** the DM clears a single source, **Then** that source's data is removed; stat blocks for its creatures require re-fetching, while other cached sources remain.
|
17. **Given** the source management UI is open, **When** the DM clears a single source, **Then** that source's data is removed; stat blocks for its creatures require re-fetching, while other cached sources remain.
|
||||||
18. **Given** the source management UI is open, **When** the DM clears all cached data, **Then** all source data is removed and all stat blocks require re-fetching.
|
18. **Given** the source management UI is open, **When** the DM clears all cached data, **Then** all source data is removed and all stat blocks require re-fetching.
|
||||||
19. **Given** many sources are cached, **When** the DM types a partial name in the filter input, **Then** only sources whose display name matches (case-insensitive) are shown.
|
19. **Given** many sources are cached, **When** the DM types a partial name in the filter input, **Then** only sources whose display name matches (case-insensitive) are shown.
|
||||||
|
20. **Given** the game system is Pathfinder 2e, **When** the user clicks the import button, **Then** the bulk import prompt shows the PF2e source count (~79), a Pf2eTools-based URL, and a PF2e-appropriate data volume estimate.
|
||||||
|
21. **Given** the game system is Pathfinder 2e and a PF2e source is cached, **When** the user opens a PF2e creature's stat block from that source, **Then** the PF2e stat block renders correctly from cached data.
|
||||||
|
|
||||||
### Edge Cases
|
### Edge Cases
|
||||||
|
|
||||||
@@ -273,8 +291,9 @@ As a DM with a creature pinned, I want to collapse the right (browse) panel inde
|
|||||||
|
|
||||||
## Key Entities
|
## Key Entities
|
||||||
|
|
||||||
- **Search Index** (`BestiaryIndex`): Pre-shipped lightweight dataset keyed by name + source, containing mechanical facts (name, source code, AC, HP average, DEX score, CR, initiative proficiency multiplier, size, type) for all creatures. Sufficient for adding combatants; insufficient for rendering a full stat block.
|
- **Search Index (D&D)** (`BestiaryIndex`): Pre-shipped lightweight dataset keyed by name + source, containing mechanical facts (name, source code, AC, HP average, DEX score, CR, initiative proficiency multiplier, size, type) for all creatures. Sufficient for adding combatants; insufficient for rendering a full stat block.
|
||||||
- **Source** (`BestiarySource`): A D&D publication identified by a code (e.g., "XMM") with a display name (e.g., "Monster Manual (2025)"). Caching and fetching operate at the source level.
|
- **Search Index (PF2e)** (`Pf2eBestiaryIndex`): Pre-shipped lightweight dataset for PF2e creatures, containing name, source code, AC, HP, level, Perception modifier, size, and creature type. Parallel to the D&D search index but with PF2e-specific fields (level instead of CR, Perception instead of DEX/proficiency).
|
||||||
|
- **Source** (`BestiarySource`): A D&D or PF2e publication identified by a code (e.g., "XMM") with a display name (e.g., "Monster Manual (2025)"). Caching and fetching operate at the source level.
|
||||||
- **Creature (Full)** (`Creature`): A complete creature record with all stat block data (traits, actions, legendary actions, spellcasting, etc.), available only after source data is fetched/uploaded and cached. Identified by a branded `CreatureId`.
|
- **Creature (Full)** (`Creature`): A complete creature record with all stat block data (traits, actions, legendary actions, spellcasting, etc.), available only after source data is fetched/uploaded and cached. Identified by a branded `CreatureId`.
|
||||||
- **Cached Source Data**: The full normalized bestiary data for a single source, stored in IndexedDB. Contains complete creature stat blocks.
|
- **Cached Source Data**: The full normalized bestiary data for a single source, stored in IndexedDB. Contains complete creature stat blocks.
|
||||||
- **Combatant** (extended): Gains an optional `creatureId` reference to a `Creature`, enabling stat block lookup and stat pre-fill on creation.
|
- **Combatant** (extended): Gains an optional `creatureId` reference to a `Creature`, enabling stat block lookup and stat pre-fill on creation.
|
||||||
@@ -287,7 +306,7 @@ As a DM with a creature pinned, I want to collapse the right (browse) panel inde
|
|||||||
|
|
||||||
## Success Criteria *(mandatory)*
|
## Success Criteria *(mandatory)*
|
||||||
|
|
||||||
- **SC-001**: All 3,312+ indexed creatures are searchable immediately on app load, with search results appearing within 100ms of typing.
|
- **SC-001**: All indexed creatures for the active game system (3,312+ D&D or ~2,700+ PF2e) are searchable immediately on app load, with search results appearing within 100ms of typing.
|
||||||
- **SC-002**: Adding a creature from search to the encounter completes without any network request and within 200ms.
|
- **SC-002**: Adding a creature from search to the encounter completes without any network request and within 200ms.
|
||||||
- **SC-003**: After a source is cached, stat blocks for any creature from that source display within 200ms with no additional prompt.
|
- **SC-003**: After a source is cached, stat blocks for any creature from that source display within 200ms with no additional prompt.
|
||||||
- **SC-004**: The distributed app bundle contains zero copyrighted prose content — only mechanical facts and creature names in the search index.
|
- **SC-004**: The distributed app bundle contains zero copyrighted prose content — only mechanical facts and creature names in the search index.
|
||||||
@@ -304,3 +323,7 @@ As a DM with a creature pinned, I want to collapse the right (browse) panel inde
|
|||||||
- **SC-015**: Users can pin a creature and browse a different creature's stat block simultaneously, without any additional navigation steps.
|
- **SC-015**: Users can pin a creature and browse a different creature's stat block simultaneously, without any additional navigation steps.
|
||||||
- **SC-016**: The pinned panel is never visible on screens narrower than the dual-panel breakpoint, ensuring mobile usability is not degraded.
|
- **SC-016**: The pinned panel is never visible on screens narrower than the dual-panel breakpoint, ensuring mobile usability is not degraded.
|
||||||
- **SC-017**: All collapse/expand and pin/unpin interactions are discoverable through visible button controls without requiring documentation or tooltips.
|
- **SC-017**: All collapse/expand and pin/unpin interactions are discoverable through visible button controls without requiring documentation or tooltips.
|
||||||
|
- **SC-018**: All ~2,700+ PF2e indexed creatures are searchable when PF2e is the active game system, with search results appearing within 100ms of typing.
|
||||||
|
- **SC-019**: PF2e stat blocks render the correct layout (level, three saves, ability modifiers, ability sections) for all PF2e creatures — no D&D-specific fields (CR, ability scores, legendary actions) are shown.
|
||||||
|
- **SC-020**: Switching game system immediately changes which creatures appear in search — no page reload required.
|
||||||
|
- **SC-021**: Both D&D and PF2e search indexes ship bundled with the app; no network fetch is required to search creatures in either system.
|
||||||
|
|||||||
@@ -3,7 +3,7 @@
|
|||||||
**Feature Branch**: `008-encounter-difficulty`
|
**Feature Branch**: `008-encounter-difficulty`
|
||||||
**Created**: 2026-03-27
|
**Created**: 2026-03-27
|
||||||
**Status**: Draft
|
**Status**: Draft
|
||||||
**Input**: Gitea issue #18 — "Encounter difficulty indicator (5.5e XP budget)"
|
**Input**: Gitea issue #18 — "Encounter difficulty indicator (5.5e XP budget)", Gitea issue #22 — "Combatant side assignment for encounter difficulty", Gitea issue #23 — "2014 DMG encounter difficulty calculation"
|
||||||
|
|
||||||
## User Scenarios & Testing *(mandatory)*
|
## User Scenarios & Testing *(mandatory)*
|
||||||
|
|
||||||
@@ -33,6 +33,12 @@ A game master is building an encounter by adding monsters and player characters.
|
|||||||
|
|
||||||
7. **Given** the difficulty indicator is visible, **When** a PC combatant is added or removed, **Then** the indicator updates immediately to reflect the new party budget.
|
7. **Given** the difficulty indicator is visible, **When** a PC combatant is added or removed, **Then** the indicator updates immediately to reflect the new party budget.
|
||||||
|
|
||||||
|
8. **Given** the rules edition is set to 5e (2014), **When** the indicator renders at the Low-equivalent tier, **Then** the tooltip reads "Easy encounter difficulty". **When** set to 5.5e, **Then** it reads "Low encounter difficulty".
|
||||||
|
|
||||||
|
9. **Given** the rules edition is set to 5e (2014), **When** the indicator renders at the highest tier, **Then** the tooltip reads "Deadly encounter difficulty". **When** set to 5.5e, **Then** it reads "High encounter difficulty".
|
||||||
|
|
||||||
|
10. **Given** the user switches the rules edition in settings, **When** returning to the encounter, **Then** the indicator tooltip reflects the new edition's labels immediately.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### Indicator Visibility
|
### Indicator Visibility
|
||||||
@@ -101,10 +107,18 @@ The difficulty calculation uses the 2024 5.5e XP Budget per Character table and
|
|||||||
|
|
||||||
3. **Given** a party with PCs at different levels (e.g., three level 3 and one level 2), **When** the budget is calculated, **Then** each PC's budget is looked up individually by level and summed (not averaged).
|
3. **Given** a party with PCs at different levels (e.g., three level 3 and one level 2), **When** the budget is calculated, **Then** each PC's budget is looked up individually by level and summed (not averaged).
|
||||||
|
|
||||||
4. **Given** an encounter with bestiary-linked combatants, custom combatants with CR assigned, and custom combatants without CR, **When** the XP total is calculated, **Then** bestiary-linked combatants contribute XP from their creature CR and custom combatants with CR contribute XP from their assigned CR. Custom combatants without CR are excluded.
|
4. **Given** an encounter with bestiary-linked combatants, custom combatants with CR assigned, and custom combatants without CR, **When** the XP total is calculated, **Then** enemy-side combatants with CR add XP to the monster total, party-side combatants with CR subtract XP from the monster total, and custom combatants without CR are excluded. The net monster XP is floored at 0.
|
||||||
|
|
||||||
5. **Given** a PC combatant whose player character has no level, **When** the budget is calculated, **Then** that PC is excluded from the budget (as if they are not in the party).
|
5. **Given** a PC combatant whose player character has no level, **When** the budget is calculated, **Then** that PC is excluded from the budget (as if they are not in the party).
|
||||||
|
|
||||||
|
6. **Given** the rules edition is set to 5e (2014) and an encounter has 3 enemy-side monsters totaling 300 base XP, **When** the encounter multiplier is applied, **Then** the adjusted XP is 600 (3 monsters = ×2 multiplier).
|
||||||
|
|
||||||
|
7. **Given** the rules edition is set to 5e (2014) and the party has fewer than 3 PCs, **When** the encounter multiplier is determined, **Then** the multiplier shifts one step higher (e.g., ×1.5 becomes ×2).
|
||||||
|
|
||||||
|
8. **Given** the rules edition is set to 5e (2014) and the party has 6 or more PCs, **When** the encounter multiplier is determined, **Then** the multiplier shifts one step lower (e.g., ×2 becomes ×1.5, ×1 becomes ×0.5).
|
||||||
|
|
||||||
|
9. **Given** the rules edition is set to 5e (2014), **When** facing monsters totaling 500 adjusted XP against a party of four level 3 PCs (Medium threshold: 150 each = 600 total), **Then** the difficulty is Easy (adjusted XP is below the Medium threshold).
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### Difficulty Breakdown
|
### Difficulty Breakdown
|
||||||
@@ -119,7 +133,7 @@ The game master taps the difficulty indicator to open a breakdown panel. The pan
|
|||||||
|
|
||||||
**Acceptance Scenarios**:
|
**Acceptance Scenarios**:
|
||||||
|
|
||||||
1. **Given** the difficulty indicator is visible, **When** the user taps the indicator, **Then** a breakdown panel opens showing party budget, per-combatant XP contributions, and total monster XP.
|
1. **Given** the difficulty indicator is visible, **When** the user taps the indicator, **Then** a breakdown panel opens showing party budget, two columns (Party and Enemy) listing combatants with their XP contributions, a side toggle per combatant, and the net monster XP total.
|
||||||
|
|
||||||
2. **Given** the breakdown panel is open, **When** the user taps outside the panel or taps a close control, **Then** the panel closes.
|
2. **Given** the breakdown panel is open, **When** the user taps outside the panel or taps a close control, **Then** the panel closes.
|
||||||
|
|
||||||
@@ -131,6 +145,12 @@ The game master taps the difficulty indicator to open a breakdown panel. The pan
|
|||||||
|
|
||||||
6. **Given** the breakdown panel is open, **When** a combatant is added or removed from the encounter, **Then** the panel content updates immediately.
|
6. **Given** the breakdown panel is open, **When** a combatant is added or removed from the encounter, **Then** the panel content updates immediately.
|
||||||
|
|
||||||
|
7. **Given** the breakdown panel is open, **When** the user toggles a combatant's side, **Then** it moves to the other column and the difficulty tier, monster XP total, and party budget update immediately.
|
||||||
|
|
||||||
|
8. **Given** the rules edition is set to 5e (2014) and the breakdown panel is open, **When** viewing the monster XP section, **Then** the panel shows the base monster XP total, the encounter multiplier (e.g., "×2"), and the adjusted XP total used for threshold comparison.
|
||||||
|
|
||||||
|
9. **Given** the rules edition is set to 5e (2014) and the breakdown panel is open, **When** viewing the party budget section, **Then** the panel shows four threshold columns (Easy, Medium, Hard, Deadly) instead of three (Low, Moderate, High).
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
### Manual CR Assignment
|
### Manual CR Assignment
|
||||||
@@ -177,6 +197,62 @@ Bestiary-linked combatants derive their CR from the creature data. The breakdown
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
### Side Assignment
|
||||||
|
|
||||||
|
**Story ED-8 — Assign combatants to party or enemy side (Priority: P2)**
|
||||||
|
|
||||||
|
A game master has allied NPCs fighting alongside the party. From the difficulty breakdown panel, they toggle an NPC to the party side. The NPC's XP is subtracted from the monster total instead of added, and the difficulty tier drops accordingly. PC combatants default to the party side and non-PC combatants default to the enemy side, so users who don't care about sides never interact with this feature.
|
||||||
|
|
||||||
|
**Why this priority**: Extends the breakdown panel (ED-5) with side assignment. Without sides, allied NPCs inflate difficulty artificially.
|
||||||
|
|
||||||
|
**Independent Test**: Can be tested by adding a leveled PC and two monsters, toggling one monster to party side, and verifying its XP is subtracted from the total.
|
||||||
|
|
||||||
|
**Acceptance Scenarios**:
|
||||||
|
|
||||||
|
1. **Given** the breakdown panel is open, **When** a non-PC combatant's side is toggled to party, **Then** its CR-derived XP is subtracted from the monster total instead of added, and the difficulty tier recalculates immediately.
|
||||||
|
|
||||||
|
2. **Given** a combatant with both a level (from its player character) and a CR on the party side, **When** the difficulty is calculated, **Then** it contributes to the party budget via its level AND subtracts its CR XP from the monster total — both effects apply independently.
|
||||||
|
|
||||||
|
3. **Given** party-side combatants whose total CR XP exceeds the enemy-side total, **When** the difficulty is calculated, **Then** the net monster XP is floored at 0 (difficulty cannot go negative).
|
||||||
|
|
||||||
|
4. **Given** the breakdown panel is open, **When** the user views a PC combatant, **Then** it appears in the Party column by default. **When** the user views a non-PC combatant, **Then** it appears in the Enemy column by default. Both can be toggled.
|
||||||
|
|
||||||
|
5. **Given** a combatant's side has been toggled, **When** the encounter is saved and the page is reloaded, **Then** the side assignment is restored.
|
||||||
|
|
||||||
|
6. **Given** a combatant's side has been toggled, **When** the encounter is exported to JSON and re-imported, **Then** the side assignment is preserved.
|
||||||
|
|
||||||
|
7. **Given** the breakdown panel is open, **Then** above the two columns a brief rules-oriented explanation is shown: "Allied NPC XP is subtracted from encounter difficulty" (tone is mechanical/rules-focused).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### 2014 Rules Edition
|
||||||
|
|
||||||
|
**Story ED-9 — 2014 DMG encounter difficulty calculation (Priority: P2)**
|
||||||
|
|
||||||
|
A game master who runs games using the 2014 (original 5e) rules selects "5e (2014)" in the Rules Edition setting. The difficulty indicator now uses the 2014 DMG calculation: monster XP is summed, an encounter multiplier is applied based on the number of enemy-side monsters, and the adjusted total is compared against Easy/Medium/Hard/Deadly thresholds derived from per-character XP budgets. The visual indicator maps identically — 0 bars for Easy, 1 green for Medium, 2 yellow for Hard, 3 red for Deadly — but tooltip labels and breakdown details reflect the 2014 terminology.
|
||||||
|
|
||||||
|
**Why this priority**: The core indicator (ED-1) and 5.5e calculation (ED-4) must work first. 2014 support extends the existing system with an alternative calculation path.
|
||||||
|
|
||||||
|
**Independent Test**: Can be tested by setting rules edition to 5e (2014), creating an encounter with leveled PCs and monsters, and verifying the indicator uses 2014 thresholds, multiplier, and labels.
|
||||||
|
|
||||||
|
**Acceptance Scenarios**:
|
||||||
|
|
||||||
|
1. **Given** the rules edition is set to 5e (2014) and an encounter has leveled PCs and enemy monsters, **When** the difficulty is calculated, **Then** the system uses the 2014 XP Thresholds by Character Level table (Easy/Medium/Hard/Deadly) instead of the 5.5e table (Low/Moderate/High).
|
||||||
|
|
||||||
|
2. **Given** the rules edition is set to 5e (2014) and an encounter has 3 enemy-side monsters totaling 300 base XP, **When** the encounter multiplier is applied, **Then** the adjusted XP is 600 (3 monsters = ×2 multiplier).
|
||||||
|
|
||||||
|
3. **Given** the rules edition is set to 5e (2014) and the party has fewer than 3 PCs, **When** the encounter multiplier is determined, **Then** the multiplier shifts one step higher (e.g., ×1.5 becomes ×2, ×1 becomes ×1.5).
|
||||||
|
|
||||||
|
4. **Given** the rules edition is set to 5e (2014) and the party has 6 or more PCs, **When** the encounter multiplier is determined, **Then** the multiplier shifts one step lower (e.g., ×2 becomes ×1.5, ×1 becomes ×0.5).
|
||||||
|
|
||||||
|
5. **Given** the rules edition is set to 5e (2014), **When** the indicator visual states are rendered, **Then** 0 bars = Easy, 1 green bar = Medium, 2 yellow bars = Hard, 3 red bars = Deadly.
|
||||||
|
|
||||||
|
6. **Given** the user changes the rules edition from 5.5e to 5e (2014) while an encounter is open, **When** the setting is saved, **Then** the difficulty indicator updates immediately to reflect the 2014 calculation and labels.
|
||||||
|
|
||||||
|
7. **Given** the rules edition is set to 5e (2014) and only enemy-side combatants count toward monster count, **When** a party-side NPC with CR is present, **Then** its XP is subtracted from the total but it does not inflate the encounter multiplier monster count.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
### Edge Cases
|
### Edge Cases
|
||||||
|
|
||||||
- **All bars empty (trivial)**: When total monster XP is greater than 0 but below the Low threshold, the indicator shows three empty bars. This communicates "we can calculate, but it's trivial."
|
- **All bars empty (trivial)**: When total monster XP is greater than 0 but below the Low threshold, the indicator shows three empty bars. This communicates "we can calculate, but it's trivial."
|
||||||
@@ -190,6 +266,14 @@ Bestiary-linked combatants derive their CR from the creature data. The breakdown
|
|||||||
- **PCs without level silently excluded**: PC combatants whose player character has no level do not contribute to the budget and are not flagged.
|
- **PCs without level silently excluded**: PC combatants whose player character has no level do not contribute to the budget and are not flagged.
|
||||||
- **Indicator with empty encounter**: When the encounter has no combatants, the indicator is hidden (the top bar may not even render per existing behavior).
|
- **Indicator with empty encounter**: When the encounter has no combatants, the indicator is hidden (the top bar may not even render per existing behavior).
|
||||||
- **Level field on existing player characters**: Existing player characters created before this feature will have no level. They are treated as "no level assigned" — no migration or default is needed.
|
- **Level field on existing player characters**: Existing player characters created before this feature will have no level. They are treated as "no level assigned" — no migration or default is needed.
|
||||||
|
- **Net monster XP floored at 0**: If party-side combatant XP exceeds enemy-side combatant XP, the net monster XP is 0 (trivial), not negative.
|
||||||
|
- **Dual contribution (level + CR on party side)**: A combatant with both a level and a CR on the party side contributes to the party budget via level and subtracts from monster XP via CR. These are independent effects.
|
||||||
|
- **Side defaults preserve opt-in**: Because PCs default to party and others default to enemy, users who never assign sides see identical behavior to the pre-side-assignment calculation.
|
||||||
|
- **2014 encounter multiplier with party-side NPCs**: Only enemy-side combatants count toward the monster count for determining the encounter multiplier. Party-side NPCs with CR subtract their XP from the total but do not increase the monster count.
|
||||||
|
- **2014 party size adjustment boundaries**: Exactly 3 PCs uses the standard multiplier. Exactly 5 PCs uses the standard multiplier. The shift only applies at fewer than 3 or 6 or more.
|
||||||
|
- **2014 multiplier floor (×0.5)**: A single monster with 6+ PCs uses ×0.5 per the 2014 DMG party size adjustment rule.
|
||||||
|
- **2014 multiplier ceiling (×5)**: 15+ monsters with fewer than 3 PCs shifts ×4 upward to ×5 per the 2014 DMG party size adjustment rule.
|
||||||
|
- **Edition switch with breakdown panel open**: If the breakdown panel is open when the user switches editions in settings, the panel content updates to reflect the new edition's labels, thresholds, and (for 2014) the encounter multiplier.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -206,11 +290,11 @@ The system MUST contain a CR-to-XP lookup table mapping all standard 5e challeng
|
|||||||
#### FR-003 — Party XP budget calculation
|
#### FR-003 — Party XP budget calculation
|
||||||
The system MUST calculate the party's XP budget by summing the per-character budget for each PC combatant whose player character has a level assigned. PCs without a level are excluded from the sum.
|
The system MUST calculate the party's XP budget by summing the per-character budget for each PC combatant whose player character has a level assigned. PCs without a level are excluded from the sum.
|
||||||
|
|
||||||
#### FR-004 — Monster XP total calculation
|
#### FR-004 — Net monster XP calculation
|
||||||
The system MUST calculate the total monster XP by summing the XP value (derived from CR) for each combatant that has a CR. For bestiary-linked combatants, CR is derived from the creature data via `creatureId`. For custom combatants, CR comes from the optional `cr` field. Combatants with neither `creatureId` nor `cr` are excluded.
|
The system MUST calculate the net monster XP by summing the XP value (derived from CR) for each enemy-side combatant that has a CR and subtracting the XP value for each party-side combatant that has a CR. For bestiary-linked combatants, CR is derived from the creature data via `creatureId`. For custom combatants, CR comes from the optional `cr` field. Combatants with neither `creatureId` nor `cr` are excluded. The net monster XP MUST be floored at 0.
|
||||||
|
|
||||||
#### FR-005 — Difficulty tier determination
|
#### FR-005 — Difficulty tier determination
|
||||||
The system MUST determine the encounter difficulty tier by comparing total monster XP against the party's Low, Moderate, and High thresholds. The tier is the highest threshold that the total XP meets or exceeds. If below Low, the encounter is trivial (no tier label).
|
The system MUST determine the encounter difficulty tier by comparing total monster XP (adjusted XP for 2014) against the party's thresholds. For 5.5e: Low, Moderate, and High (3 tiers). For 2014: Easy, Medium, Hard, and Deadly (4 tiers). The tier is the highest threshold that the total XP meets or exceeds. If below the lowest threshold, the encounter is trivial (5.5e) or easy (2014). The visual indicator maps identically across editions: 0 bars = Trivial/Easy, 1 green = Low/Medium, 2 yellow = Moderate/Hard, 3 red = High/Deadly.
|
||||||
|
|
||||||
#### FR-006 — Difficulty indicator in top bar
|
#### FR-006 — Difficulty indicator in top bar
|
||||||
The system MUST display a 3-bar difficulty indicator in the top bar, positioned to the right of the active combatant name.
|
The system MUST display a 3-bar difficulty indicator in the top bar, positioned to the right of the active combatant name.
|
||||||
@@ -219,7 +303,7 @@ The system MUST display a 3-bar difficulty indicator in the top bar, positioned
|
|||||||
The indicator MUST display: three empty bars for trivial, one green filled bar for Low, two yellow filled bars for Moderate, three red filled bars for High.
|
The indicator MUST display: three empty bars for trivial, one green filled bar for Low, two yellow filled bars for Moderate, three red filled bars for High.
|
||||||
|
|
||||||
#### FR-008 — Tooltip on hover
|
#### FR-008 — Tooltip on hover
|
||||||
The indicator MUST show a tooltip on hover displaying the difficulty label (e.g., "Moderate encounter difficulty"). For the trivial state, the tooltip MUST read "Trivial encounter difficulty".
|
The indicator MUST show a tooltip on hover displaying the edition-appropriate difficulty label. For 5.5e: "Trivial/Low/Moderate/High encounter difficulty". For 2014: "Easy/Medium/Hard/Deadly encounter difficulty".
|
||||||
|
|
||||||
#### FR-009 — Live updates
|
#### FR-009 — Live updates
|
||||||
The indicator MUST update immediately when combatants are added to or removed from the encounter.
|
The indicator MUST update immediately when combatants are added to or removed from the encounter.
|
||||||
@@ -239,24 +323,60 @@ The player character level MUST be persisted and restored across sessions, consi
|
|||||||
#### FR-014 — High is the cap
|
#### FR-014 — High is the cap
|
||||||
When total monster XP exceeds the High threshold, the indicator MUST display the High state (three red bars). There is no tier above High.
|
When total monster XP exceeds the High threshold, the indicator MUST display the High state (three red bars). There is no tier above High.
|
||||||
|
|
||||||
#### FR-015 — Optional CR field on Combatant
|
#### FR-015 — Optional CR and side fields on Combatant
|
||||||
The `Combatant` entity MUST support an optional `cr` field accepting standard 5e challenge rating strings ("0", "1/8", "1/4", "1/2", "1"–"30").
|
The `Combatant` entity MUST support an optional `cr` field accepting standard 5e challenge rating strings ("0", "1/8", "1/4", "1/2", "1"–"30") and an optional `side` field accepting `"party"` or `"enemy"`.
|
||||||
|
|
||||||
#### FR-016 — Tappable difficulty indicator
|
#### FR-016 — Tappable difficulty indicator
|
||||||
The difficulty indicator MUST be tappable, opening a difficulty breakdown panel.
|
The difficulty indicator MUST be tappable, opening a difficulty breakdown panel.
|
||||||
|
|
||||||
#### FR-017 — Breakdown panel content
|
#### FR-017 — Breakdown panel content
|
||||||
The breakdown panel MUST display: the party XP budget (with Low, Moderate, High thresholds), a list of combatants showing name, CR, and XP contribution, and the total monster XP.
|
The breakdown panel MUST display: the party XP budget (with edition-appropriate tier thresholds — Low/Moderate/High for 5.5e, Easy/Medium/Hard/Deadly for 2014), two stacked sections (Party and Enemy) using a columnar grid layout (name, toggle button, CR, XP) for aligned readability, the net monster XP total, and a brief rules-oriented explanation. When the rules edition is 5e (2014), the panel MUST additionally show the encounter multiplier value and the adjusted XP total. Source names are omitted from the panel to conserve horizontal space.
|
||||||
|
|
||||||
#### FR-018 — CR picker for custom combatants
|
#### FR-018 — CR picker for custom combatants
|
||||||
The breakdown panel MUST provide a CR picker for custom combatants (those without `creatureId`) offering all standard 5e CR values: 0, 1/8, 1/4, 1/2, 1–30.
|
The breakdown panel MUST provide a CR picker for custom combatants (those without `creatureId`) offering all standard 5e CR values: 0, 1/8, 1/4, 1/2, 1–30.
|
||||||
|
|
||||||
#### FR-019 — Bestiary CR precedence
|
#### FR-019 — Bestiary CR precedence
|
||||||
When a combatant has a `creatureId`, the system MUST derive CR from the linked creature data. The manual `cr` field MUST be ignored. The breakdown panel MUST display bestiary-linked CRs as read-only with the source name visible.
|
When a combatant has a `creatureId`, the system MUST derive CR from the linked creature data. The manual `cr` field MUST be ignored. The breakdown panel MUST display bestiary-linked CRs as read-only.
|
||||||
|
|
||||||
#### FR-020 — CR persistence
|
#### FR-020 — CR persistence
|
||||||
The `cr` field on `Combatant` MUST persist within the encounter across page reloads (via encounter storage) and MUST round-trip through JSON export/import.
|
The `cr` field on `Combatant` MUST persist within the encounter across page reloads (via encounter storage) and MUST round-trip through JSON export/import.
|
||||||
|
|
||||||
|
#### FR-021 — Side defaults
|
||||||
|
When `side` is undefined, PC combatants MUST default to party side and all other combatants MUST default to enemy side. The `useDifficulty` hook resolves defaults before calling the domain function.
|
||||||
|
|
||||||
|
#### FR-022 — Party-side CR subtraction
|
||||||
|
Party-side combatants with CR MUST have their XP subtracted from the monster total. Party-side combatants with level MUST contribute to the party budget. These effects are independent — a combatant with both level and CR on party side contributes to budget AND subtracts from monster XP.
|
||||||
|
|
||||||
|
#### FR-023 — Side toggle in breakdown panel
|
||||||
|
The breakdown panel MUST provide a side toggle button per non-PC combatant to switch between party and enemy side. PC combatants are fixed to the party side and do not show a toggle. Toggling MUST immediately update the difficulty calculation. The toggle button uses an arrow icon with a hover background effect for discoverability.
|
||||||
|
|
||||||
|
#### FR-024 — Side persistence
|
||||||
|
The `side` field on `Combatant` MUST persist within the encounter across page reloads (via encounter storage) and MUST round-trip through JSON export/import.
|
||||||
|
|
||||||
|
#### FR-025 — Domain function signature
|
||||||
|
The `calculateEncounterDifficulty` domain function MUST accept combatant descriptors with `{ level?, cr?, side }` and a `RulesEdition` parameter so it can apply the correct calculation logic and threshold tables for the selected edition, replacing the current `partyLevels[]` / `monsterCrs[]` signature.
|
||||||
|
|
||||||
|
#### FR-026 — 2014 XP Thresholds by Character Level table
|
||||||
|
The system MUST contain the 2014 DMG XP Thresholds by Character Level lookup table mapping character levels 1-20 to four XP thresholds: Easy, Medium, Hard, and Deadly.
|
||||||
|
|
||||||
|
#### FR-027 — 2014 Encounter Multiplier table
|
||||||
|
The system MUST contain the 2014 DMG Encounter Multiplier lookup table: 1 monster = ×1, 2 monsters = ×1.5, 3-6 monsters = ×2, 7-10 monsters = ×2.5, 11-14 monsters = ×3, 15+ monsters = ×4.
|
||||||
|
|
||||||
|
#### FR-028 — Party size multiplier adjustment
|
||||||
|
When using 2014 rules, the system MUST adjust the encounter multiplier based on party size: fewer than 3 PCs shifts the multiplier one step higher (up to ×5), 6 or more PCs shifts it one step lower (down to ×0.5). Per the 2014 DMG: a single monster vs 6+ PCs uses ×0.5, and 15+ monsters vs fewer than 3 PCs uses ×5.
|
||||||
|
|
||||||
|
#### FR-029 — 2014 adjusted XP calculation
|
||||||
|
When using 2014 rules, the system MUST calculate adjusted XP by summing the base XP of all enemy-side combatants with CR, applying the encounter multiplier (based on enemy-side monster count and party size), and comparing the adjusted total against the party's Easy/Medium/Hard/Deadly thresholds. Only enemy-side combatants count toward the monster count for the multiplier. Party-side combatant XP subtraction is applied to the base total before the multiplier.
|
||||||
|
|
||||||
|
#### FR-030 — Party size adjustment explanation in breakdown panel
|
||||||
|
When using 2014 rules and the party size adjustment is active (fewer than 3 or 6 or more PCs), the breakdown panel MUST display a brief explanation near the multiplier (e.g., "×1.5 adjusted for 2 PCs" or "×1.5 adjusted for 6 PCs") so the GM understands why the multiplier differs from the base table.
|
||||||
|
|
||||||
|
#### FR-031 — Edition switch updates indicator
|
||||||
|
Switching the rules edition in settings MUST immediately update the difficulty indicator for the current encounter without requiring a page reload.
|
||||||
|
|
||||||
|
#### FR-032 — Settings label reflects broader scope
|
||||||
|
The settings modal section currently labeled "Conditions" MUST be relabeled to "Rules Edition" to reflect that the edition toggle controls both condition descriptions and difficulty calculation. This supersedes spec 003 FR-096 which scoped the label to conditions only.
|
||||||
|
|
||||||
### Key Entities
|
### Key Entities
|
||||||
|
|
||||||
- **XP Budget Table**: A lookup mapping character level (1-20) to three XP thresholds (Low, Moderate, High), sourced from the 2024 5.5e DMG.
|
- **XP Budget Table**: A lookup mapping character level (1-20) to three XP thresholds (Low, Moderate, High), sourced from the 2024 5.5e DMG.
|
||||||
@@ -265,6 +385,9 @@ The `cr` field on `Combatant` MUST persist within the encounter across page relo
|
|||||||
- **DifficultyResult**: The output of the calculation containing the tier, total monster XP, and per-tier budget thresholds.
|
- **DifficultyResult**: The output of the calculation containing the tier, total monster XP, and per-tier budget thresholds.
|
||||||
- **PlayerCharacter.level**: An optional integer (1-20) added to the existing `PlayerCharacter` entity defined in spec 005.
|
- **PlayerCharacter.level**: An optional integer (1-20) added to the existing `PlayerCharacter` entity defined in spec 005.
|
||||||
- **Combatant.cr**: An optional string field on the existing `Combatant` entity, accepting standard 5e CR values. Used for manual CR assignment on custom combatants. Ignored when the combatant has a `creatureId`.
|
- **Combatant.cr**: An optional string field on the existing `Combatant` entity, accepting standard 5e CR values. Used for manual CR assignment on custom combatants. Ignored when the combatant has a `creatureId`.
|
||||||
|
- **Combatant.side**: An optional string field (`"party"` | `"enemy"`) on the existing `Combatant` entity. When undefined, defaults are resolved by the hook layer: PC combatants default to `"party"`, all others to `"enemy"`.
|
||||||
|
- **2014 XP Thresholds Table**: A lookup mapping character level (1-20) to four XP thresholds (Easy, Medium, Hard, Deadly), sourced from the 2014 DMG.
|
||||||
|
- **EncounterMultiplier**: A lookup mapping monster count ranges to base multiplier values (×1 through ×4), with party size adjustment shifting the multiplier up or down one step (full range ×0.5 through ×5).
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -281,6 +404,9 @@ The `cr` field on `Combatant` MUST persist within the encounter across page relo
|
|||||||
- **SC-007**: The optional level field integrates seamlessly into the existing player character create/edit workflow without disrupting existing functionality.
|
- **SC-007**: The optional level field integrates seamlessly into the existing player character create/edit workflow without disrupting existing functionality.
|
||||||
- **SC-008**: The difficulty breakdown panel correctly displays per-combatant XP contributions and party budget that sum to the values used for tier determination.
|
- **SC-008**: The difficulty breakdown panel correctly displays per-combatant XP contributions and party budget that sum to the values used for tier determination.
|
||||||
- **SC-009**: Custom combatants with manually assigned CR contribute correctly to the difficulty calculation, matching the same CR-to-XP mapping used for bestiary creatures.
|
- **SC-009**: Custom combatants with manually assigned CR contribute correctly to the difficulty calculation, matching the same CR-to-XP mapping used for bestiary creatures.
|
||||||
|
- **SC-010**: Party-side combatants with CR correctly subtract their XP from the monster total, and the net XP is never negative.
|
||||||
|
- **SC-011**: The 2014 difficulty calculation correctly applies encounter multipliers and party size adjustments per the 2014 DMG rules.
|
||||||
|
- **SC-012**: Switching rules edition immediately updates the indicator with no page reload required.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -293,6 +419,8 @@ The `cr` field on `Combatant` MUST persist within the encounter across page relo
|
|||||||
- Existing player characters without a level are treated as "no level assigned" with no migration.
|
- Existing player characters without a level are treated as "no level assigned" with no migration.
|
||||||
- The difficulty indicator occupies minimal horizontal space in the top bar and does not interfere with the combatant name truncation or other controls.
|
- The difficulty indicator occupies minimal horizontal space in the top bar and does not interfere with the combatant name truncation or other controls.
|
||||||
- The breakdown panel is the sole UI surface for manual CR assignment — there is no CR field in the combatant create/edit forms.
|
- The breakdown panel is the sole UI surface for manual CR assignment — there is no CR field in the combatant create/edit forms.
|
||||||
- MVP baseline does not include assigning combatants to party/enemy sides — all combatants with CR are counted as enemies.
|
- The 2014 DMG XP Thresholds and Encounter Multiplier tables are static data that do not change at runtime.
|
||||||
- MVP baseline does not include the 2014 DMG encounter multiplier mechanic or the four-tier (Easy/Medium/Hard/Deadly) system.
|
- The existing `RulesEdition` type (`"5e" | "5.5e"`) already maps correctly — `"5e"` corresponds to the 2014 rules, `"5.5e"` to the 2024 rules. No new enum value is needed.
|
||||||
|
- The CR-to-XP lookup table is shared between both editions — only the budget thresholds and multiplier logic differ.
|
||||||
|
- MVP baseline does not include the 2014 Adventuring Day XP budget or multipart encounter rules.
|
||||||
- MVP baseline does not include per-combatant level overrides — level is always derived from the player character template.
|
- MVP baseline does not include per-combatant level overrides — level is always derived from the player character template.
|
||||||
|
|||||||
Reference in New Issue
Block a user