@optolith/entity-descriptions 0.13.2 → 0.14.0

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable changes to this project will be documented in this file. See [commit-and-tag-version](https://github.com/absolute-version/commit-and-tag-version) for commit guidelines.
 
+## [0.14.0](https://github.com/Optolith/entity-descriptions/compare/v0.13.2...v0.14.0) (2026-09-24)
+
+### ⚠ BREAKING CHANGES
+
+* **deps:** upgrade to schema 0.65.0
+
+### build
+
+* **deps:** upgrade to schema 0.65.0 ([cb94c96](https://github.com/Optolith/entity-descriptions/commit/cb94c96df8dc3f1d4f5476db729df2ed85ce6b1d))
+
+### Bug Fixes
+
+* missing adventure points label for AP value by level ([9aabd43](https://github.com/Optolith/entity-descriptions/commit/9aabd437d587e7b559c18a730249ea3c66bb8387))
 ## [0.13.2](https://github.com/Optolith/entity-descriptions/compare/v0.13.1...v0.13.2) (2026-09-16)
 
 ### Features

package/lib/creator.js

@@ -64,7 +64,7 @@ export const createEntityDescriptionCreator = (fn) => (databaseAccessors, locale
         ...rawEntry,
         body: rawEntry.body.filter(isNotNullish).map(mapRawSection),
         errata: rawEntry.errata?.map(({ date, description }) => ({
-            date: locale.formatDate(date),
+            date: locale.formatDate(new Date(date)),
             description: description.trim(),
         })),
         references: rawEntry.references === undefined

package/lib/entities/activatable.js

@@ -44,6 +44,10 @@ const renderAdvantageDisadvantageSubtype = (subtype) => {
             return translateR("Magical Rank");
         case "MagicalTitle":
             return translateR("Magical Title");
+        case "BlessedRank":
+            return translateR("Blessed Title");
+        case "BlessedTitle":
+            return translateR("Blessed Title");
         default:
             return assertExhaustive(subtype);
     }
@@ -311,7 +315,9 @@ const renderVolumeValue = (translate, translateMap, getAllResolvedSelectOptions,
                 levels: volume.ByLevel.list.map((_, index) => romanize(index + 1)).join("/"),
             });
         case "Map":
-            return renderParameterMap(volume.Map, option => Reader.of(option.points), values => translateR("{$points} points", { points: values })).run({
+            return renderParameterMap(volume.Map, option => Reader.of(option.points), values => translateR("{$points} points", {
+                points: typeof values === "number" ? values.toFixed() : values,
+            })).run({
                 translate,
                 translateMap,
                 responsiveTextSize,
@@ -342,7 +348,7 @@ const renderArcaneEnergyCost = (translate, translateMap, format, localeJoin, res
                 ? value => translate(".input {$value :number} {{{$value} permanent AE}}", {
                     value,
                 })
-                : value => translate("{$value} AE", { value });
+                : value => translate("{$value} AE", { value: value.toFixed() });
             const { interval } = cost.Fixed;
             const wrapInInterval = interval === undefined
                 ? str => str
@@ -370,40 +376,40 @@ const renderArcaneEnergyCost = (translate, translateMap, format, localeJoin, res
             return wrapInPerLevel(value => wrapInInterval(translationWrapper(value))) + noteInParens;
         }
         case "Constant":
-            return (translate("{$value} AE", { value: cost.Constant.value }) +
+            return (translate("{$value} AE", { value: cost.Constant.value.toFixed() }) +
                 (cost.Constant.permanent_value === undefined
                     ? ""
                     : translate(", {$value} of which are permanent", {
-                        value: cost.Constant.permanent_value,
+                        value: cost.Constant.permanent_value.toFixed(),
                     })));
         case "PerCountable": {
             const translation = translateMap(cost.PerCountable.translations);
             return ((cost.PerCountable.base_value === undefined
                 ? ""
-                : `${translate("{$value} AE", { value: cost.PerCountable.base_value })} + `) +
+                : `${translate("{$value} AE", { value: cost.PerCountable.base_value.toFixed() })} + `) +
                 translate("{$cost} per {$countable}", {
-                    cost: translate("{$value} AE", { value: cost.PerCountable.value }),
+                    cost: translate("{$value} AE", { value: cost.PerCountable.value.toFixed() }),
                     countable: getResponsiveText(translation?.per, responsiveTextSize),
                 }) +
                 parensIf(mapNullable(translation?.note, note => getResponsiveTextOptional(note, responsiveTextSize))));
         }
         case "Interval":
             return translate("{$cost} per {$interval}", {
-                cost: translate("{$value} AE", { value: cost.Interval.value }),
+                cost: translate("{$value} AE", { value: cost.Interval.value.toFixed() }),
                 interval: formatTimeSpan(translate, translateMap, format, responsiveTextSize, cost.Interval.interval.unit, cost.Interval.interval.value, true),
             });
         case "ActivationAndHalfInterval":
             return additionFormatter(translate("{$value} AE", {
-                value: cost.ActivationAndHalfInterval.value,
+                value: cost.ActivationAndHalfInterval.value.toFixed(),
             }) + parensIf(translate("activation")), translate("{$cost} per {$interval}", {
                 cost: translate("{$value} AE", {
-                    value: Math.round(cost.ActivationAndHalfInterval.value / 2),
+                    value: Math.round(cost.ActivationAndHalfInterval.value / 2).toFixed(),
                 }),
                 interval: formatTimeSpan(translate, translateMap, format, responsiveTextSize, cost.ActivationAndHalfInterval.interval.unit, cost.ActivationAndHalfInterval.interval.value, true),
             }));
         case "Indefinite":
             return ((mapNullable(translateMap(cost.Indefinite.translations)?.description, description => getResponsiveText(description, responsiveTextSize)) ?? MISSING_VALUE) +
-                mapNullableDefault(cost.Indefinite.modifier, modifier => ` + ${translate("{$value} AE", { value: modifier.value })}`, ""));
+                mapNullableDefault(cost.Indefinite.modifier, modifier => ` + ${translate("{$value} AE", { value: modifier.value.toFixed() })}`, ""));
         case "Disjunction":
             return translate("{$value} AE", {
                 value: localeJoin(cost.Disjunction.options.map(option => option.value.toFixed() +
@@ -430,7 +436,7 @@ const renderArcaneEnergyCost = (translate, translateMap, format, localeJoin, res
                 case "Verbose":
                     return cost.ByLevel.levels
                         .map((level, index) => translate("{$cost} for level {$level}", {
-                        cost: translate("{$value} AE", { value: level.value }),
+                        cost: translate("{$value} AE", { value: level.value.toFixed() }),
                         level: romanize(index + 1),
                     }))
                         .join("; ");
@@ -454,7 +460,9 @@ const renderBindingCost = (translate, translateMap, localeCompare, getAllResolve
                 }),
             });
         case "Map":
-            return renderParameterMap(cost.Map, option => Reader.of(option.permanentValue), values => translateR("{$value} permanent AE", { value: values })).run({
+            return renderParameterMap(cost.Map, option => Reader.of(option.permanentValue), values => translateR("{$value} permanent AE", {
+                value: typeof values === "number" ? values.toFixed() : values,
+            })).run({
                 translate,
                 translateMap,
                 responsiveTextSize,
@@ -481,12 +489,12 @@ const renderBindingCost = (translate, translateMap, localeCompare, getAllResolve
 const renderLifePointsCost = (translate, cost) => cost === undefined
     ? ""
     : // eslint-disable-next-line no-irregular-whitespace
-        ` (+ ${translate("{$value} LP", { value: cost.Fixed.value })})`;
+        ` (+ ${translate("{$value} LP", { value: cost.Fixed.value.toFixed() })})`;
 const renderCost = (translate, translateMap, format, localeJoin, localeCompare, getAllResolvedSelectOptions, responsiveTextSize, levels, cost) => {
     if (typeof cost === "number") {
         return {
             label: translate("AE Cost"),
-            value: translate("{$value} AE", { value: cost }),
+            value: translate("{$value} AE", { value: cost.toFixed() }),
         };
     }
     switch (cost.kind) {

package/lib/entities/culture.js

@@ -248,14 +248,14 @@ export const getCultureEntityDescription = createEntityDescriptionCreator(({ get
                                 if (allSame(processedScripts, on(([, apValue]) => apValue, equal))) {
                                     return (localeJoin(processedScripts.map(([name]) => name).toSorted(localeCompare), "disjunction") +
                                         parensIf(translate("{$value} AP", {
-                                            value: processedScripts[0][1],
+                                            value: processedScripts[0][1].toFixed(),
                                         })));
                                 }
                                 else {
                                     return localeJoin(processedScripts
                                         .map(([name, apValue]) => name +
                                         parensIf(translate("{$value} AP", {
-                                            value: apValue,
+                                            value: apValue.toFixed(),
                                         })))
                                         .toSorted(localeCompare), "disjunction");
                                 }
@@ -306,7 +306,7 @@ export const getCultureEntityDescription = createEntityDescriptionCreator(({ get
                 type: "labeled",
                 label: translate("Cultural Package {$cultureName}", {
                     cultureName: translation.name,
-                }) + parensIf(translate("{$value} AP", { value: culturalPackageApValue })),
+                }) + parensIf(translate("{$value} AP", { value: culturalPackageApValue.toFixed() })),
                 value: {
                     type: "plain",
                     text: culturePackageText,

package/lib/entities/curriculum.js

@@ -183,7 +183,7 @@ const renderAbilityAdjustment = (translate, translateMap, getInstanceById, baseP
         const printedBaseValue = mapNullable(renderPrintedAbilityAdjustmentBaseValue(abilityAdjustment), value => value + defaultValue);
         return translate("{$replacement} instead of {$base}", {
             base: printedBaseValue === basePoints
-                ? basePoints
+                ? basePoints.toFixed()
                 : `<ins>${basePoints.toFixed()}</ins><del>${printedBaseValue?.toFixed() ?? "n/a"}</del>`,
             replacement: `${renderAbilityAdjustmentName(translateMap, getInstanceById, abilityAdjustment)} ${(basePoints + renderAbilityAdjustmentModifierValue(abilityAdjustment)).toFixed()}`,
         });

package/lib/entities/elixir.js

@@ -54,7 +54,7 @@ export const getElixirEntityDescription = createEntityDescriptionCreator(({ getI
                     {
                         label: `${translate("AP Value")} (${translate("Trade Secret")})`,
                         value: translate("{$value} AP", {
-                            value: entry.trade_secret.ap_value,
+                            value: entry.trade_secret.ap_value.toFixed(),
                         }) +
                             parensIf(mapNullable(entry.trade_secret.prerequisites, prerequisites => `${translate("Prerequisites")}: ${printPlainGeneralPrerequisites(prerequisites).run(env)}`)),
                     },

package/lib/entities/equipment.js

@@ -239,7 +239,7 @@ const renderComplexity = (translate, complexity) => mapNullable(complexity, c =>
                 return translate("Simple");
             case "Complex":
                 return `${translate("Complex")} (${translate("{$value} AP", {
-                    value: c.Complex.ap_value,
+                    value: c.Complex.ap_value.toFixed(),
                 })})`;
             case "Various":
                 return translate("Various");

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>;