@optolith/entity-descriptions 0.13.2 → 0.15.0

package/lib/entities/equipmentPackage.d.ts

@@ -5,4 +5,4 @@ import type { GetInstanceById } from "../helpers/getTypes.js";
  */
 export declare const getEquipmentPackageEntityDescription: import("../creator.js").EntityDescriptionCreator<"EquipmentPackage", {
     getInstanceById: GetInstanceById<"Publication" | EquipmentIdentifier["kind"] | "SocialStatus">;
-}, import("../index.js").EntityDescription>;
+} & import("../env.js").StdEnv<"fd" | "t" | "tm" | "ibi", "Publication">, import("../index.js").EntityDescription<string>>;

package/lib/entities/experienceLevel.d.ts

@@ -1,6 +1,4 @@
 /**
  * Get a JSON representation of the rules text for an experience level.
  */
-export declare const getExperienceLevelEntityDescription: import("../creator.js").EntityDescriptionCreator<"ExperienceLevel", {
-    getInstanceById: import("../helpers/getTypes.js").GetInstanceById<"Publication">;
-}, import("../index.js").EntityDescription>;
+export declare const getExperienceLevelEntityDescription: import("../creator.js").EntityDescriptionCreator<"ExperienceLevel", import("@elyukai/utils/nullable").AnyNonNullish & import("../env.js").StdEnv<"fd" | "t" | "tm" | "ibi", "Publication">, import("../index.js").EntityDescription<string>>;

package/lib/entities/focusRule.d.ts

@@ -4,4 +4,4 @@ import type { GetInstanceById } from "../helpers/getTypes.js";
  */
 export declare const getFocusRuleEntityDescription: import("../creator.js").EntityDescriptionCreator<"FocusRule", {
     getInstanceById: GetInstanceById<"Publication" | "Subject">;
-}, import("../index.js").EntityDescription>;
+} & import("../env.js").StdEnv<"fd" | "t" | "tm" | "ibi", "Publication">, import("../index.js").EntityDescription<string>>;

package/lib/entities/influence.d.ts

@@ -8,4 +8,4 @@ export declare const getInfluenceEntityDescription: import("../creator.js").Enti
     getInstanceById: GetInstanceById<"Publication" | "Influence" | "Race" | ActivatableIdentifier["kind"] | "Aspect">;
     getResolvedSelectOptionById: GetResolvedSelectOptionById;
     getChildInstancesForInstanceId: GetAllChildInstancesForParent<"ProfessionVersion">;
-}, import("../index.js").EntityDescription>;
+} & import("../env.js").StdEnv<"fd" | "t" | "tm" | "ibi", "Publication">, import("../index.js").EntityDescription<string>>;

package/lib/entities/liturgicalChant.d.ts

@@ -7,7 +7,7 @@ import type { IdMap } from "../index.js";
 export declare const getBlessingEntityDescription: import("../creator.js").EntityDescriptionCreator<"Blessing", {
     getInstanceById: GetInstanceById<"Publication" | "TargetCategory">;
     getAllInstances: GetAllInstances<"BlessedTradition">;
-}, import("../index.js").EntityDescription>;
+} & import("../env.js").StdEnv<"fd" | "t" | "tm" | "ibi", "Publication">, import("../index.js").EntityDescription<string>>;
 /**
  * Get a JSON representation of the rules text for a liturgical chant.
  */
@@ -15,7 +15,7 @@ export declare const getLiturgicalChantEntityDescription: import("../creator.js"
     getInstanceById: GetInstanceById<"Publication" | "Attribute" | "SkillModificationLevel" | "TargetCategory" | "Aspect" | "BlessedTradition" | "DerivedCharacteristic" | RatedIdentifier["kind"] | "Enhancement" | "FocusRule">;
     getChildInstancesForInstanceId: GetAllChildInstancesForParent<"Enhancement">;
     idMap: IdMap;
-}, import("../index.js").EntityDescription>;
+} & import("../env.js").StdEnv<"fd" | "t" | "tm" | "ibi", "Publication">, import("../index.js").EntityDescription<string>>;
 /**
  * Get a JSON representation of the rules text for a ceremony.
  */
@@ -23,4 +23,4 @@ export declare const getCeremonyEntityDescription: import("../creator.js").Entit
     getInstanceById: GetInstanceById<"Publication" | "Attribute" | "SkillModificationLevel" | "TargetCategory" | "Aspect" | "BlessedTradition" | "DerivedCharacteristic" | RatedIdentifier["kind"] | "Enhancement" | "FocusRule">;
     getChildInstancesForInstanceId: GetAllChildInstancesForParent<"Enhancement">;
     idMap: IdMap;
-}, import("../index.js").EntityDescription>;
+} & import("../env.js").StdEnv<"fd" | "t" | "tm" | "ibi", "Publication">, import("../index.js").EntityDescription<string>>;

package/lib/entities/optionalRule.d.ts

@@ -1,6 +1,4 @@
 /**
  * Get a JSON representation of the rules text for an optional rule.
  */
-export declare const getOptionalRuleEntityDescription: import("../creator.js").EntityDescriptionCreator<"OptionalRule", {
-    getInstanceById: import("../helpers/getTypes.js").GetInstanceById<"Publication">;
-}, import("../index.js").EntityDescription>;
+export declare const getOptionalRuleEntityDescription: import("../creator.js").EntityDescriptionCreator<"OptionalRule", import("@elyukai/utils/nullable").AnyNonNullish & import("../env.js").StdEnv<"fd" | "t" | "tm" | "ibi", "Publication">, import("../index.js").EntityDescription<string>>;

package/lib/entities/partial/adventurePointsValue.js

@@ -35,7 +35,7 @@ const renderFixedSelectOptionsAdventurePointsValue = (locale, getAllSelectOption
                 .toSorted(locale.compare), "conjunction"),
         ])
             .toSorted(on(item => item[1], locale.compare))
-            .map(([apValue, itemNames]) => `${itemNames}: ${locale.translate("{$value} Adventure Points", { value: typeof apValue === "number" ? applyNegative(apValue) : apValue })}`)
+            .map(([apValue, itemNames]) => `${itemNames}: ${locale.translate("{$value} Adventure Points", { value: typeof apValue === "number" ? applyNegative(apValue).toFixed() : apValue })}`)
             .join("; ");
     }
 };
@@ -88,12 +88,13 @@ export const renderAdventurePointsValue = (locale, getNameForId, getNameForSelec
             if (entry.levels !== value.ByLevel.list.length) {
                 return MISSING_VALUE;
             }
-            const mainValue = `${translate("Level {$level}", {
+            const levelsPrefix = translate("Level {$level}", {
                 level: Array.from({ length: entry.levels }, (_, index) => romanize(index + 1)).join("/"),
-            })}: ${value.ByLevel.list.map(applyNegative).join("/")}`;
+            });
+            const mainValues = value.ByLevel.list.map(applyNegative).join("/");
             const { additionalBySizeCategory } = value.ByLevel;
             if (additionalBySizeCategory === undefined) {
-                return mainValue;
+                return translate("{$value} Adventure Points", { value: mainValues });
             }
             else {
                 const sizeCategories = ["tiny", "small", "medium", "large", "huge"];
@@ -101,7 +102,7 @@ export const renderAdventurePointsValue = (locale, getNameForId, getNameForSelec
                     .map(sizeCategory => applyNegative(additionalBySizeCategory[sizeCategory]))
                     .join("/");
                 const labels = sizeCategories.map(sizeCategory => translate(sizeCategory)).join("/");
-                return `${mainValue} + ${translate("{$values} AP for size category {$labels} (per level)", { values, labels })}`;
+                return `${levelsPrefix}: ${mainValues} + ${translate("{$values} AP for size category {$labels} (per level)", { values, labels })}`;
             }
         }
         case "DerivedFromSelection": {
@@ -281,13 +282,13 @@ export const renderAdventurePointsValue = (locale, getNameForId, getNameForSelec
                     const labels = Array.from({ length: entry.maximum ?? 3 }, (_, index) => `${(index + 1).toFixed()}.`).join("/");
                     if (entry.maximum !== undefined) {
                         return translate("{$values} Adventure Points for the {$labels} purchase", {
-                            values,
+                            values: values.join("/"),
                             labels,
                         });
                     }
                     else {
                         return translate("{$values}/and so on Adventure Points for the {$labels}/and so on purchase", {
-                            values,
+                            values: values.join("/"),
                             labels,
                         });
                     }

package/lib/entities/partial/dice.js

@@ -3,11 +3,11 @@ import { translateR } from "./reader.js";
 /**
  * Renders a dice expression like "2D6" into a localized string.
  */
-export const renderDice = (translate, dice) => translate("{$count}D{$sides}", { count: dice.number, sides: dice.sides });
+export const renderDice = (translate, dice) => translate("{$count}D{$sides}", { count: dice.number.toFixed(), sides: dice.sides.toFixed() });
 /**
  * Renders a dice expression like "2D6" into a localized string.
  */
-export const renderDiceR = (dice) => translateR("{$count}D{$sides}", { count: dice.number, sides: dice.sides });
+export const renderDiceR = (dice) => translateR("{$count}D{$sides}", { count: dice.number.toFixed(), sides: dice.sides.toFixed() });
 /**
  * Renders a dice expression with an additional flat modifier, like "2D6+3" or "2D6-1".
  */

package/lib/entities/partial/enhancements.js

@@ -22,8 +22,8 @@ const renderEnhancement = (enhancement, parentImprovementCost) => {
     const { prerequisites } = enhancement.content;
     return translateMapR(enhancement.content.translations).thenW(translation => translation === undefined
         ? Reader.of(undefined)
-        : translateR("SR {$value}", { value: enhancement.content.skill_rating }).thenW(sr => translateR("{$value} AP", {
-            value: getEnhancementAPValue(enhancement.content.adventurePoints, parentImprovementCost),
+        : translateR("SR {$value}", { value: enhancement.content.skill_rating.toFixed() }).thenW(sr => translateR("{$value} AP", {
+            value: getEnhancementAPValue(enhancement.content.adventurePoints, parentImprovementCost).toFixed(),
         }).thenW(ap => (prerequisites === undefined
             ? Reader.of("")
             : translateR(".input {$hiddenCount :number} {{Prerequisites}}", {

package/lib/entities/partial/herbary.js

@@ -47,7 +47,7 @@ export const renderChance = (translate, translateMap, item, includePercentage =
     (item.chance === undefined
         ? undefined
         : translate("{$valueRange} on {$dice}", {
-            valueRange: item.chance === 5 ? 1 : `1–${(item.chance / 5).toFixed()}`,
+            valueRange: item.chance === 5 ? "1" : `1–${(item.chance / 5).toFixed()}`,
             dice: renderDice(translate, { number: 1, sides: 20 }),
         }) +
             (includePercentage

package/lib/entities/partial/prerequisites/single/personalityTrait.js

@@ -12,7 +12,7 @@ export const printPersonalityTraitPrerequisite = (prerequisite) => prerequisite.
         : attributedNameFromInstanceR(personalityTrait, "prerequisite", "PersonalityTrait", prerequisite.id)
             .map(name => name ?? MISSING_VALUE)
             .thenW(name => translateR("Level {$level}", {
-            level: personalityTrait.level,
+            level: personalityTrait.level.toFixed(),
         }).map(level => `${name} (${level})`))
             .then(name => prerequisite.active
             ? translateR("must have {$trait}", {

package/lib/entities/partial/prerequisites/single/ratedSum.js

@@ -13,7 +13,7 @@ export const printRatedSumPrerequisite = (prerequisite) => prerequisite.display_
         .thenW(skills => localeJoinR(skills, "conjunction"))
         .thenW(skills => translateR("the SR for {$skill} combined must add up to at least {$minRating}", {
         skill: skills,
-        minRating: prerequisite.sum,
+        minRating: prerequisite.sum.toFixed(),
     }))
         .map(value => ({
         value,

package/lib/entities/partial/profession/options/combatTechniquesForAdventurePoints.d.ts

@@ -0,0 +1,16 @@
+import type { NonEmptyArray } from "@elyukai/utils/array/nonEmpty";
+import { Reader } from "@elyukai/utils/reader";
+import type { CombatTechniquesForAdventurePointsOption, VariantOptionAction } from "@optolith/database-schema/gen";
+import type { StdEnv } from "../../../../env.js";
+import { type PreparedProfessionPackage } from "../packages.js";
+type Option = CombatTechniquesForAdventurePointsOption;
+type OptionEnv = StdEnv<"t" | "tm" | "ibi", "CloseCombatTechnique" | "RangedCombatTechnique">;
+/**
+ * Renders the combat techniques for adventure points option for a list of profession packages.
+ */
+export declare const renderBaseCombatTechniquesForAdventurePointsOption: (professionPackages: NonEmptyArray<PreparedProfessionPackage>) => Reader<OptionEnv, string | undefined>;
+/**
+ * Renders the combat techniques for adventure points option for a variant of a profession package.
+ */
+export declare const renderVariantCombatTechniquesForAdventurePointsOption: (baseOptions: Option | undefined, variantOptions: VariantOptionAction<Option>) => Reader<OptionEnv, string>;
+export {};

package/lib/entities/partial/profession/options/combatTechniquesForAdventurePoints.js

@@ -0,0 +1,43 @@
+import { deepEqual, equal } from "@elyukai/utils/equality";
+import { Reader } from "@elyukai/utils/reader";
+import { attributedNameR, fixedNumberOrString, translateR } from "../../reader.js";
+import { MISSING_VALUE } from "../../unknown.js";
+import { renderParameterizedOptionForBaseAndVariant, renderParameterizedOptionForMultiplePackages, } from "../packages.js";
+const renderCombatTechniquesForAdventurePointsOptionList = (options) => Reader.traverse(options, id => attributedNameR("profession", id).map(name => name ?? MISSING_VALUE)).map(list => list.join(", "));
+const renderCombatTechniquesForAdventurePointsOptionText = (apValue, list) => translateR("{$apValue} AP to distribute among the following combat techniques: {$list}", {
+    apValue: fixedNumberOrString(apValue),
+    list,
+});
+const renderStandaloneOption = (option) => renderCombatTechniquesForAdventurePointsOptionList(option.options).thenW(list => renderCombatTechniquesForAdventurePointsOptionText(option.apValue.toFixed(), list));
+const configs = [
+    {
+        selector: option => option.apValue,
+        equality: equal,
+        render: apValue => Reader.of(apValue),
+        renderAsString: apValue => Reader.of(apValue.toFixed()),
+        emptyText: "—",
+        joiner: "/",
+    },
+    {
+        selector: option => option.options,
+        equality: deepEqual,
+        render: renderCombatTechniquesForAdventurePointsOptionList,
+        renderAsString: renderCombatTechniquesForAdventurePointsOptionList,
+        emptyText: "—",
+        joiner: " / ",
+    },
+];
+const render = (apValue, list) => translateR("{$apValue} AP to distribute among the following combat techniques: {$list}", {
+    apValue: fixedNumberOrString(apValue),
+    list,
+});
+/**
+ * Renders the combat techniques for adventure points option for a list of profession packages.
+ */
+export const renderBaseCombatTechniquesForAdventurePointsOption = (professionPackages) => renderParameterizedOptionForMultiplePackages(professionPackages, pkg => pkg.content.options?.combatTechniquesForAdventurePoints, { type: "separate", emptyText: "—", joiner: " / " }, render, ...configs);
+/**
+ * Renders the combat techniques for adventure points option for a variant of a profession package.
+ */
+export const renderVariantCombatTechniquesForAdventurePointsOption = (baseOptions, variantOptions) => renderParameterizedOptionForBaseAndVariant(baseOptions, variantOptions, { type: "separate", emptyText: "—", joiner: " / " }, base => renderCombatTechniquesForAdventurePointsOptionList(base.options).thenW(list => translateR("no AP to distribute among the following combat techniques: {$list}", {
+    list,
+})), renderStandaloneOption, render, ...configs);

package/lib/entities/partial/profession/options/numberOfSpellworksTotalingAdventurePoints.d.ts

@@ -0,0 +1,16 @@
+import type { NonEmptyArray } from "@elyukai/utils/array/nonEmpty";
+import { Reader } from "@elyukai/utils/reader";
+import type { SpellworksOptions, VariantOptionAction } from "@optolith/database-schema/gen";
+import type { StdEnv } from "../../../../env.js";
+import { type PreparedProfessionPackage } from "../packages.js";
+type Option = SpellworksOptions;
+type OptionEnv = StdEnv<"t">;
+/**
+ * Renders the combat techniques for adventure points option for a list of profession packages.
+ */
+export declare const renderBaseNumberOfSpellworksTotalingAdventurePoints: (professionPackages: NonEmptyArray<PreparedProfessionPackage>) => Reader<OptionEnv, string | undefined>;
+/**
+ * Renders the combat techniques for adventure points option for a variant of a profession package.
+ */
+export declare const renderVariantNumberOfSpellworksTotalingAdventurePoints: (baseOptions: Option | undefined, variantOptions: VariantOptionAction<Option>) => Reader<OptionEnv, string>;
+export {};

package/lib/entities/partial/profession/options/numberOfSpellworksTotalingAdventurePoints.js

@@ -0,0 +1,39 @@
+import { equal } from "@elyukai/utils/equality";
+import { Reader } from "@elyukai/utils/reader";
+import { fixedNumberOrString, translateR } from "../../reader.js";
+import { renderParameterizedOptionForBaseAndVariant, renderParameterizedOptionForMultiplePackages, } from "../packages.js";
+const configs = [
+    {
+        selector: option => option.number,
+        equality: equal,
+        render: apValue => Reader.of(apValue),
+        renderAsString: apValue => Reader.of(apValue.toFixed()),
+        emptyText: "—",
+        joiner: "/",
+    },
+    {
+        selector: option => option.apValue,
+        equality: equal,
+        render: apValue => Reader.of(apValue),
+        renderAsString: apValue => Reader.of(apValue.toFixed()),
+        emptyText: "—",
+        joiner: "/",
+    },
+];
+const render = (count, apValue) => typeof count === "number"
+    ? translateR(".input {$count :number} {{{$count} more spellworks totaling {$apValue} AP}}", {
+        count,
+        apValue: fixedNumberOrString(apValue),
+    })
+    : translateR("{$count} more spellworks totaling {$apValue} AP", {
+        count,
+        apValue: fixedNumberOrString(apValue),
+    });
+/**
+ * Renders the combat techniques for adventure points option for a list of profession packages.
+ */
+export const renderBaseNumberOfSpellworksTotalingAdventurePoints = (professionPackages) => renderParameterizedOptionForMultiplePackages(professionPackages, pkg => pkg.content.options?.spellworks, { type: "separate", emptyText: "—", joiner: " / " }, render, ...configs);
+/**
+ * Renders the combat techniques for adventure points option for a variant of a profession package.
+ */
+export const renderVariantNumberOfSpellworksTotalingAdventurePoints = (baseOptions, variantOptions) => renderParameterizedOptionForBaseAndVariant(baseOptions, variantOptions, { type: "separate", emptyText: "—", joiner: " / " }, base => render(0, base.apValue), base => render(base.number, base.apValue), render, ...configs);

package/lib/entities/partial/profession/packages.d.ts

@@ -0,0 +1,67 @@
+import type { NonEmptyArray } from "@elyukai/utils/array/nonEmpty";
+import type { Equality } from "@elyukai/utils/equality";
+import type { AnyNonNullish } from "@elyukai/utils/nullable";
+import { Reader } from "@elyukai/utils/reader";
+import type { ExperienceLevel, Profession_ID, ProfessionPackage, VariantOptionAction } from "@optolith/database-schema/gen";
+import type { StdEnv, StdReader } from "../../../env.js";
+/**
+ * Profession Package with its associated experience level.
+ */
+export type PreparedProfessionPackage = {
+    id: string;
+    content: ProfessionPackage;
+    experienceLevel: ExperienceLevel;
+};
+/**
+ * Collects all profession packages for a given profession and returns them sorted by their associated experience level.
+ */
+export declare const prepareProfessionPackages: (professionId: Profession_ID) => StdReader<PreparedProfessionPackage[], "ibi" | "acibp", "ExperienceLevel", never, "ProfessionPackage">;
+/**
+ * Configuration for retrieving, rendering and combining an option parameter.
+ */
+export type OptionParameterConfig<T, P, R, E> = {
+    selector: (option: T) => P;
+    equality: Equality<P | undefined>;
+    render: (option: P) => Reader<E, R>;
+    renderAsString: (option: P) => Reader<E, string>;
+    emptyText: string;
+    joiner: string;
+};
+type OptionParameterValueMap = [value: unknown, result: unknown][];
+/**
+ * Option parameter configurations for multiple parameters.
+ */
+export type OptionParameterConfigs<T, P extends OptionParameterValueMap, E> = {
+    [K in keyof P]: OptionParameterConfig<T, P[K][0], P[K][1], E>;
+};
+/**
+ * Extract parameters for final text render.
+ */
+type OptionParameterTextRenderParameters<P extends OptionParameterValueMap> = {
+    [K in keyof P]: P[K][1] | string;
+};
+/**
+ * Renders the text for multiple parameters.
+ */
+export type OptionParameterTextRender<P extends OptionParameterValueMap, E> = (...args: OptionParameterTextRenderParameters<P>) => Reader<E, string>;
+/**
+ * Renders a two-parameter option for a list of profession packages.
+ */
+export declare const renderParameterizedOptionForMultiplePackages: <T, P extends OptionParameterValueMap, E>(professionPackages: NonEmptyArray<PreparedProfessionPackage>, optionSelector: (pkg: PreparedProfessionPackage) => T | undefined, allDifferent: {
+    type: "separate";
+    emptyText: string;
+    joiner: string;
+} | {
+    type: "combined";
+}, renderText: OptionParameterTextRender<P, E>, ...configs: OptionParameterConfigs<T, P, E>) => Reader<E, string | undefined>;
+/**
+ * Renders a two-parameter option for a list of profession packages.
+ */
+export declare const renderParameterizedOptionForBaseAndVariant: <T extends AnyNonNullish, P extends OptionParameterValueMap, E>(baseOptions: T | undefined, variantOptions: VariantOptionAction<T>, allDifferent: {
+    type: "separate";
+    emptyText: string;
+    joiner: string;
+} | {
+    type: "combined";
+}, renderRemove: (base: T) => Reader<E, string>, renderAdd: (override: T) => Reader<E, string>, renderText: OptionParameterTextRender<P, E>, ...configs: OptionParameterConfigs<T, P, E>) => Reader<E & StdEnv<"t">, string>;
+export {};

package/lib/entities/partial/profession/packages.js

@@ -0,0 +1,84 @@
+import { allSame } from "@elyukai/utils/array/filters";
+import { on } from "@elyukai/utils/function";
+import { compareNumber } from "@elyukai/utils/ordering";
+import { Reader } from "@elyukai/utils/reader";
+import { assertExhaustive } from "@elyukai/utils/typeSafety";
+import { LOGIC_ERROR } from "../unknown.js";
+import { insteadOfR, renderVariantOptionPaths } from "./variants.js";
+/**
+ * Collects all profession packages for a given profession and returns them sorted by their associated experience level.
+ */
+export const prepareProfessionPackages = (professionId) => Reader.asks(({ getInstanceById, getChildInstancesForInstanceId }) => getChildInstancesForInstanceId("ProfessionPackage", professionId)
+    .map((professionPackage) => ({
+    ...professionPackage,
+    experienceLevel: getInstanceById("ExperienceLevel", professionPackage.content.experience_level),
+}))
+    .filter((professionPackage) => professionPackage.experienceLevel !== undefined)
+    .toSorted(on(item => item.experienceLevel.adventure_points, compareNumber)));
+const renderSeparatedOptionList = (options, render, emptyText, joiner) => Reader.traverse(options, option => option === undefined ? Reader.of(emptyText) : render(option)).map(list => list.join(joiner));
+/**
+ * Renders a two-parameter option for a list of profession packages.
+ */
+export const renderParameterizedOptionForMultiplePackages = (professionPackages, optionSelector, allDifferent, renderText, ...configs) => {
+    const options = professionPackages.map(optionSelector);
+    const [firstOption] = options;
+    const sames = configs.map(config => allSame(options, on(option => (option === undefined ? undefined : config.selector(option)), config.equality)));
+    if (sames.some(same => same)) {
+        if (firstOption === undefined) {
+            return Reader.of(undefined);
+        }
+        return Reader.traverse(configs, (config, configIndex) => sames[configIndex] === true
+            ? config.render(config.selector(firstOption))
+            : renderSeparatedOptionList(options, option => config.renderAsString(config.selector(option)), config.emptyText, config.joiner)).thenW(parameterValues => renderText(...parameterValues));
+    }
+    else {
+        switch (allDifferent.type) {
+            case "combined":
+                return Reader.traverse(configs, config => renderSeparatedOptionList(options, option => config.renderAsString(config.selector(option)), config.emptyText, config.joiner)).thenW(parameterValues => renderText(...parameterValues));
+            case "separate":
+                return renderSeparatedOptionList(options, option => Reader.traverse(configs, config => config.render(config.selector(option))).thenW(parameterValues => renderText(...parameterValues)), allDifferent.emptyText, allDifferent.joiner);
+            default:
+                return assertExhaustive(allDifferent);
+        }
+    }
+};
+/**
+ * Renders a two-parameter option for a list of profession packages.
+ */
+export const renderParameterizedOptionForBaseAndVariant = (baseOptions, variantOptions, allDifferent, renderRemove, renderAdd, renderText, ...configs) => renderVariantOptionPaths(baseOptions, variantOptions, {
+    remove: renderRemove,
+    add: renderAdd,
+    update: (base, override) => {
+        const sames = configs.map(config => config.equality(config.selector(base), config.selector(override)));
+        if (sames.every(same => same)) {
+            return Reader.of(LOGIC_ERROR); // Base and variant would be equal then, so the variant option should be removed or changed
+        }
+        if (sames.some(same => same)) {
+            return Reader.traverse(configs, (config, configIndex) => sames[configIndex] === true
+                ? config.render(config.selector(base))
+                : config
+                    .renderAsString(config.selector(base))
+                    .thenW(baseValue => config
+                    .renderAsString(config.selector(override))
+                    .thenW(overrideValue => insteadOfR(overrideValue, baseValue)))).thenW(parameterValues => renderText(...parameterValues));
+        }
+        else {
+            switch (allDifferent.type) {
+                case "combined":
+                    return Reader.traverse(configs, config => config
+                        .renderAsString(config.selector(base))
+                        .thenW(baseValue => config
+                        .renderAsString(config.selector(override))
+                        .thenW(overrideValue => insteadOfR(overrideValue, baseValue)))).thenW(parameterValues => renderText(...parameterValues));
+                case "separate":
+                    return Reader.traverse(configs, config => config.render(config.selector(base)))
+                        .thenW(parameterValues => renderText(...parameterValues))
+                        .thenW(baseValue => Reader.traverse(configs, config => config.render(config.selector(override)))
+                        .thenW(parameterValues => renderText(...parameterValues))
+                        .thenW(overrideValue => insteadOfR(overrideValue, baseValue)));
+                default:
+                    return assertExhaustive(allDifferent);
+            }
+        }
+    },
+});

package/lib/entities/partial/profession/variants.d.ts

@@ -0,0 +1,21 @@
+import { type AnyNonNullish } from "@elyukai/utils/nullable";
+import { Reader } from "@elyukai/utils/reader";
+import type { ProfessionPackage, ProfessionPackageOptions, ProfessionVariant, ProfessionVariantPackageOptions, VariantOptionAction } from "@optolith/database-schema/gen";
+/**
+ * Renders an option for a profession variant, using the base profession package and the variant's options.
+ */
+export declare const renderVariantOption: <Env, K extends keyof ProfessionVariantPackageOptions>(base: ProfessionPackage, variant: ProfessionVariant, key: K, render: (base: ProfessionPackageOptions[K] | undefined, variant: NonNullable<ProfessionVariantPackageOptions[K]>) => Reader<Env, string>) => Reader<Env, string[]>;
+/**
+ * Render a variant option based on whether it is a removal, addition, or override of the base option.
+ */
+export declare const renderVariantOptionPaths: <T extends AnyNonNullish, Env1, Env2, Env3>(base: T | undefined, variant: VariantOptionAction<T>, paths: {
+    remove: (base: T) => Reader<Env1, string>;
+    add: (variant: T) => Reader<Env2, string>;
+    update: (base: T, variant: T) => Reader<Env3, string>;
+}) => Reader<Env1 & Env2 & Env3, string>;
+/**
+ * Helper for "X instead of Y" text.
+ */
+export declare const insteadOfR: (replacement: string | number, base: string | number) => Reader<{
+    translate: import("../../../helpers/translate.js").Translate;
+}, string>;

package/lib/entities/partial/profession/variants.js

@@ -0,0 +1,31 @@
+import { nullableToArray } from "@elyukai/utils/nullable";
+import { Reader } from "@elyukai/utils/reader";
+import { assertExhaustive } from "@elyukai/utils/typeSafety";
+import { fixedNumberOrString, translateR } from "../reader.js";
+import { MISSING_VALUE } from "../unknown.js";
+/**
+ * Renders an option for a profession variant, using the base profession package and the variant's options.
+ */
+export const renderVariantOption = (base, variant, key, render) => (variant.options?.[key] === undefined
+    ? Reader.of(undefined)
+    : render(base.options?.[key], variant.options[key])).map(text => nullableToArray(text));
+/**
+ * Render a variant option based on whether it is a removal, addition, or override of the base option.
+ */
+export const renderVariantOptionPaths = (base, variant, paths) => {
+    switch (variant.kind) {
+        case "Remove":
+            return base === undefined ? Reader.of(MISSING_VALUE) : paths.remove(base);
+        case "Override":
+            return base === undefined ? paths.add(variant.Override) : paths.update(base, variant.Override);
+        default:
+            return assertExhaustive(variant);
+    }
+};
+/**
+ * Helper for "X instead of Y" text.
+ */
+export const insteadOfR = (replacement, base) => translateR("{$replacement} instead of {$base}", {
+    replacement: fixedNumberOrString(replacement),
+    base: fixedNumberOrString(base),
+});

package/lib/entities/partial/rated/activatable/cost.js

@@ -3,7 +3,7 @@ import { Reader } from "@elyukai/utils/reader";
 import { mapNullable } from "@optolith/helpers/nullable";
 import { assertExhaustive } from "@optolith/helpers/typeSafety";
 import { renderParameterMap } from "../../map.js";
-import { formatEnergyFnR, formatEnergyR, getInstanceByIdFnR, modifiableBySpeedR, responsiveLocaleJoinR, responsiveR, responsiveTextR, responsiveTranslateR, translateMapR, translateR, } from "../../reader.js";
+import { fixedNumberOrString, formatEnergyFnR, formatEnergyR, getInstanceByIdFnR, modifiableBySpeedR, responsiveLocaleJoinR, responsiveR, responsiveTextR, responsiveTranslateR, responsiveTranslateSplitR, translateMapR, translateR, } from "../../reader.js";
 import { appendNoteIfNeeded, replaceTextIfNeeded } from "../../responsiveText.js";
 import { formatCombinedTimeSpanR } from "../../units/timeSpan.js";
 import { MISSING_VALUE } from "../../unknown.js";
@@ -33,9 +33,11 @@ const appendPerCountableToCostIfNeeded = (value, baseCost) => {
             })));
     });
 };
-const appendPermanentCostIfNeeded = (permanentValue, baseCost) => mapNullable(permanentValue, value => responsiveTranslateR(".input {$value :number} {{, {$value} of which are permanent}}", " ({$value} perm.)", { value }).map(text => baseCost + text)) ?? Reader.of(baseCost);
-const appendElvenPermanentCostIfNeeded = (permanent, baseCost) => mapNullable(permanent, value => responsiveTranslateR(".input {$value :number} {{{$value} permanent AE}}", "{$value} pAE", {
+const appendPermanentCostIfNeeded = (permanentValue, baseCost) => mapNullable(permanentValue, value => responsiveTranslateSplitR(".input {$value :number} {{, {$value} of which are permanent}}", " ({$value} perm.)", { value }, { value: value.toFixed() }).map(text => baseCost + text)) ?? Reader.of(baseCost);
+const appendElvenPermanentCostIfNeeded = (permanent, baseCost) => mapNullable(permanent, value => responsiveTranslateSplitR(".input {$value :number} {{{$value} permanent AE}}", "{$value} pAE", {
     value: value.value,
+}, {
+    value: value.value.toFixed(),
 })
     .thenW(text => replaceTextIfNeeded(value.translations, text))
     .map(text => baseCost + text)) ?? Reader.of(baseCost);
@@ -117,7 +119,7 @@ const renderMultipleOneTimeCosts = (type, value) => {
 export const renderStandaloneCostMap = (value) => renderParameterMap(value, option => Reader.of(option.value), formatEnergyR, value.options.every(option => option.value.permanentValue !== undefined)
     ? {
         format: values => translateR(", {$value} of which are permanent", {
-            value: values,
+            value: fixedNumberOrString(values),
         }),
         // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- is checked beforehand
         render: option => Reader.of(option.value.permanentValue),
@@ -132,7 +134,7 @@ const renderOneTimeCostMap = (value) => {
             return renderParameterMap(value.Modifiable.map, option => deriveModifiableCost(option.initialModificationLevel).map(cost => cost ?? MISSING_VALUE), singleValue => formatEnergyR(singleValue), value.Modifiable.map.options.every(option => option.value.permanentValue !== undefined)
                 ? {
                     format: values => translateR(", {$value} of which are permanent", {
-                        value: values,
+                        value: fixedNumberOrString(values),
                     }),
                     // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- is checked beforehand
                     render: option => Reader.of(option.value.permanentValue),
@@ -142,7 +144,7 @@ const renderOneTimeCostMap = (value) => {
             return renderParameterMap(value.NonModifiable.map, option => Reader.of(option.value), formatEnergyR, value.NonModifiable.map.options.every(option => option.value.permanentValue !== undefined)
                 ? {
                     format: values => translateR(", {$value} of which are permanent", {
-                        value: values,
+                        value: fixedNumberOrString(values),
                     }),
                     // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- is checked beforehand
                     render: option => Reader.of(option.value.permanentValue),
@@ -240,10 +242,10 @@ export const renderMagicalActionCost = (cost) => {
         case "FirstPerson":
             return Reader.asks(({ translate }) => translate("{$firstPersonValue} for the first person; {$additionalPersonValue} for each additional person", {
                 firstPersonValue: translate("{$value} AE", {
-                    value: cost.FirstPerson.value,
+                    value: cost.FirstPerson.value.toFixed(),
                 }),
                 additionalPersonValue: translate("{$value} AE", {
-                    value: cost.FirstPerson.value / 2,
+                    value: (cost.FirstPerson.value / 2).toFixed(),
                 }),
             }));
         case "ByPrimaryPatron":
@@ -252,7 +254,7 @@ export const renderMagicalActionCost = (cost) => {
             return Reader.asks(({ translate }) => cost.All.minimum === undefined
                 ? translate("All AE")
                 : translate("All AE, at least {$value} AE", {
-                    value: cost.All.minimum,
+                    value: cost.All.minimum.toFixed(),
                 }));
         case "Map":
             return renderStandaloneCostMap(cost.Map);

package/lib/entities/partial/rated/activatable/effect.js

@@ -1,6 +1,6 @@
 import { mapNullable } from "@optolith/helpers/nullable";
 import { assertExhaustive } from "@optolith/helpers/typeSafety";
-import { translateFnR } from "../../reader.js";
+import { fixedNumberOrString, translateFnR } from "../../reader.js";
 const getContentPartsForQualityLevels = (getQualityLevelString, source) => translateFnR.map((translate) => ({
     label: translate("Effect"),
     value: [
@@ -13,7 +13,7 @@ const getContentPartsForQualityLevels = (getQualityLevelString, source) => trans
             style: "hidden",
             items: source.quality_levels.map((text, index) => ({
                 label: translate("QL {$value}", {
-                    value: getQualityLevelString(index),
+                    value: fixedNumberOrString(getQualityLevelString(index)),
                 }),
                 value: text,
             })),