export function spriteImageName (layer, key, state) { return `${layer}:${key}:${state}`; } export function bloomImageName (layer, key, state) { return `${spriteImageName(layer, key, state)}:bloom`; } export function equipImageName (layer, key, state) { return `${spriteImageName(layer, key, state)}:equip`; } export function equipBloomImageName (layer, key, state) { return `${equipImageName(layer, key, state)}:bloom`; } /** Bloom companion for any registered image name (`item:stick:stick:equip` → `…:equip:bloom`). */ export function bloomCompanionName (imageName) { return `${imageName}:bloom`; } /** * Companion suffixes peel from the right in fixed order. * `torch-equip-bloom` → base torch, equip + bloom. * `torch-bloom` → base torch, bloom. * `stick-equip` → base stick, equip. */ export function parseSpriteStem (stem) { let rest = String(stem ?? ""); let bloom = false; let equip = false; if (rest.endsWith("-bloom") && rest.length > "-bloom".length) { bloom = true; rest = rest.slice(0, -"-bloom".length); } if (rest.endsWith("-equip") && rest.length > "-equip".length) { equip = true; rest = rest.slice(0, -"-equip".length); } const companion = bloom || equip; return { base: companion ? rest : String(stem ?? ""), companion, bloom, equip }; } export function isCompanionSpriteStem (stem) { return parseSpriteStem(stem).companion; } export function resolveState (states, requested) { if (!states?.length) { return null; } if (requested && !isCompanionSpriteStem(requested) && states.includes(requested)) { return requested; } return states[0]; } export function cycleState (states, current, direction) { if (!states?.length) { return null; } const resolved = resolveState(states, current); const index = states.indexOf(resolved); const step = direction < 0 ? -1 : 1; return states[(index + step + states.length) % states.length]; } export function catalogGroup (catalog, layer) { if (layer === "ground") { return catalog?.grounds; } if (layer === "block") { return catalog?.blocks; } if (layer === "item") { return catalog?.items; } if (layer === "mob") { return catalog?.mobs; } if (layer === "character") { return catalog?.characters; } return null; } export function statesForType (catalog, layer, key) { return (catalogGroup(catalog, layer)?.[key]?.states ?? []) .filter((state) => !isCompanionSpriteStem(state)); } export function defaultStateForType (catalog, layer, key) { const group = catalogGroup(catalog, layer)?.[key]; return group?.defaultState ?? resolveState(statesForType(catalog, layer, key), null); }