@optolith/entity-descriptions 0.3.1 → 0.3.2

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 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.3.2](https://github.com/Optolith/entity-descriptions/compare/v0.3.1...v0.3.2) (2026-03-12)
+
+
+### Features
+
+* render enhancements ([5159f07](https://github.com/Optolith/entity-descriptions/commit/5159f07d772e75166dce4298e3817ea2ec61f8e1))
+
 ## [0.3.1](https://github.com/Optolith/entity-descriptions/compare/v0.3.0...v0.3.1) (2026-02-25)
 
 ## [0.3.0](https://github.com/Optolith/entity-descriptions/compare/v0.2.1...v0.3.0) (2026-02-25)

package/lib/entities/culture.js

@@ -11,9 +11,9 @@ import { createEntityDescriptionCreator } from "../creator.js";
 import { renderCommonnessRatedAdvantagesOrDisadvantages, renderValueWithPossibleTranslation, } from "./partial/commonnessRatedAdvantagesAndDisadvantages.js";
 import { getProfessionName } from "./partial/professions.js";
 import { parensIf } from "./partial/rated/activatable/parensIf.js";
-import { calculateAdventurePointsFromImprovementCost } from "./partial/rated/improvementCost.js";
 import { translateR, } from "./partial/reader.js";
 import { MISSING_VALUE } from "./partial/unknown.js";
+import { getAdventurePointsForRatingRange } from "@optolith/adventure-points/improvement-cost";
 const renderListOperation = (operation, list) => {
     switch (operation.kind) {
         case "Intersection":
@@ -162,7 +162,7 @@ const renderCulturalPackage = (items) => Reader.asks(({ translate, translateMap,
         }
         return [
             `${instanceTranslation.name ?? MISSING_VALUE} ${sign(item.points)}`,
-            calculateAdventurePointsFromImprovementCost(instance.improvement_cost, [1, item.points]),
+            getAdventurePointsForRatingRange(instance.improvement_cost.kind, 0, item.points),
         ];
     });
     return {

package/lib/entities/equipment.d.ts

@@ -18,7 +18,7 @@ export declare const renderRangedWeapon: <Damage>(translate: Translate, translat
 /**
  * Get a JSON representation of the rules text for equipment.
  */
-export declare const getEquipmentEntityDescription: import("../creator.js").EntityDescriptionCreator<"Weapon" | "Armor" | "Ammunition" | "Animal" | "AnimalCare" | "BandageOrRemedy" | "Book" | "CeremonialItem" | "Clothes" | "ClothingPackage" | "Container" | "EquipmentOfBlessedOnes" | "GemOrPreciousStone" | "IlluminationLightSource" | "IlluminationRefillOrSupply" | "Jewelry" | "Laboratory" | "Liebesspielzeug" | "LuxuryGood" | "MagicalArtifact" | "MusicalInstrument" | "Newspaper" | "OrienteeringAid" | "RopeOrChain" | "Stationery" | "ThievesTool" | "ToolOfTheTrade" | "TravelGearOrTool" | "Vehicle" | "WeaponAccessory", {
+export declare const getEquipmentEntityDescription: import("../creator.js").EntityDescriptionCreator<"Weapon" | "Armor" | "Ammunition" | "Animal" | "AnimalCare" | "BandageOrRemedy" | "Book" | "CeremonialItem" | "Clothes" | "ClothingPackage" | "Container" | "EquipmentOfBlessedOnes" | "GemOrPreciousStone" | "IlluminationLightSource" | "IlluminationRefillOrSupply" | "Jewelry" | "Laboratory" | "Liebesspielzeug" | "LuxuryGood" | "MagicalArtifact" | "MusicalInstrument" | "Newspaper" | "OrienteeringAid" | "RopeOrChain" | "Stationery" | "ThievesTool" | "ToolOfTheTrade" | "TravelGearOrTool" | "Vehicle" | "WeaponAccessory" | "WorkingSupernaturalCreature", {
     getInstanceById: GetInstanceById<"Publication" | "Attribute" | "Reach" | "SocialStatus" | "CloseCombatTechnique" | "RangedCombatTechnique" | "MagicalTradition" | "BlessedTradition" | "DerivedCharacteristic" | "Ammunition" | "Race" | "Culture" | "Profession">;
     idMap: IdMap;
 }, import("../index.js").EntityDescription>;

package/lib/entities/equipment.js

@@ -3,9 +3,9 @@ import { isNotNullish } from "@elyukai/utils/nullable";
 import { sign } from "@elyukai/utils/string/number";
 import { assertExhaustive } from "@elyukai/utils/typeSafety";
 import { mapNullable } from "@optolith/helpers/nullable";
-import { createEntityDescriptionCreator, } from "../creator.js";
+import { createEntityDescriptionCreator } from "../creator.js";
 import { renderDice, renderDiceAndFlat } from "./partial/dice.js";
-import { additionFormatter, subtractionFormatter, } from "./partial/mathOperation.js";
+import { additionFormatter, subtractionFormatter } from "./partial/mathOperation.js";
 import { parensIf } from "./partial/rated/activatable/parensIf.js";
 import { ResponsiveTextSize } from "./partial/responsiveText.js";
 import { formatTimeSpan } from "./partial/units/timeSpan.js";
@@ -16,8 +16,8 @@ import { MISSING_VALUE, UNHANDLED_VALUE } from "./partial/unknown.js";
 export const getEquipmentName = (translate, translateMap, getInstanceById, entry) => {
     switch (entry.entity) {
         case "ClothingPackage": {
-            const socialStatusName = translateMap(getInstanceById("SocialStatus", entry.content.socialStatus)
-                ?.translations)?.name ?? MISSING_VALUE;
+            const socialStatusName = translateMap(getInstanceById("SocialStatus", entry.content.socialStatus)?.translations)
+                ?.name ?? MISSING_VALUE;
             return translate("Clothing Package {$socialStatus}", {
                 socialStatus: socialStatusName,
             });
@@ -53,8 +53,8 @@ export const getEquipmentName = (translate, translateMap, getInstanceById, entry
         case "Vehicle":
         case "Weapon":
         case "WeaponAccessory":
-            return (translateMap(entry.content.translations)?.name ??
-                MISSING_VALUE);
+        case "WorkingSupernaturalCreature":
+            return translateMap(entry.content.translations)?.name ?? MISSING_VALUE;
         default:
             return assertExhaustive(entry);
     }
@@ -63,24 +63,18 @@ const renderPrimaryAttributeAndDamageThreshold = (translateMap, getInstanceById,
     if (damageThreshold === undefined) {
         return "—";
     }
-    const getAttrAbbrv = (attrId) => translateMap(getInstanceById("Attribute", attrId)?.translations)
-        ?.abbreviation ?? MISSING_VALUE;
+    const getAttrAbbrv = (attrId) => translateMap(getInstanceById("Attribute", attrId)?.translations)?.abbreviation ?? MISSING_VALUE;
     switch (damageThreshold.kind) {
         case "Default":
-            return `${closeCombatTechnique?.primary_attribute.map(getAttrAbbrv).join("/") ??
-                MISSING_VALUE} ${damageThreshold.Default.threshold}`;
+            return `${closeCombatTechnique?.primary_attribute.map(getAttrAbbrv).join("/") ?? MISSING_VALUE} ${damageThreshold.Default.threshold}`;
         case "List":
             if (isNotEmpty(damageThreshold.List.list)) {
                 const { list } = damageThreshold.List;
                 if (list.some(item => item.threshold !== list[0].threshold)) {
-                    return list
-                        .map(item => `${getAttrAbbrv(item.attribute)} ${item.threshold}`)
-                        .join("/");
+                    return list.map(item => `${getAttrAbbrv(item.attribute)} ${item.threshold}`).join("/");
                 }
                 else {
-                    return `${list
-                        .map(item => getAttrAbbrv(item.attribute))
-                        .join("/")} ${list[0].threshold}`;
+                    return `${list.map(item => getAttrAbbrv(item.attribute)).join("/")} ${list[0].threshold}`;
                 }
             }
             else {
@@ -95,8 +89,7 @@ const renderAttackParryModifier = (attackModifier, parryModifier) => attackModif
     : `${attackModifier === undefined ? "—" : sign(attackModifier)}/${parryModifier === undefined ? "—" : sign(parryModifier)}`;
 const renderReach = (translateMap, getInstanceById, reach) => reach === undefined
     ? "—"
-    : (translateMap(getInstanceById("Reach", reach)?.translations)?.name ??
-        MISSING_VALUE);
+    : (translateMap(getInstanceById("Reach", reach)?.translations)?.name ?? MISSING_VALUE);
 const renderLength = (translate, measurements, length) => length === undefined
     ? "—"
     : translate(".input {$value :number} {{{$value} inches}}", {
@@ -164,8 +157,7 @@ const renderReloadTime = (translate, reloadTime) => isNotEmpty(reloadTime)
 const renderRangeBrackets = (rangeBrackets) => `${rangeBrackets.close}/${rangeBrackets.medium}/${rangeBrackets.far}`;
 const renderAmmunition = (translateMap, getInstanceById, ammunition) => ammunition === undefined
     ? "—"
-    : (translateMap(getInstanceById("Ammunition", ammunition)?.translations)
-        ?.name ?? MISSING_VALUE);
+    : (translateMap(getInstanceById("Ammunition", ammunition)?.translations)?.name ?? MISSING_VALUE);
 const renderMeleeDamage = (translate) => (damage) => renderDiceAndFlat(translate, damage.dice, damage.flat);
 /**
  * Render combat values of a ranged weapon.
@@ -242,8 +234,7 @@ const renderComplexity = (translate, complexity) => mapNullable(complexity, c =>
     })(),
 }));
 const renderBlessedTraditionRestriction = (translate, translateMap, localeJoin, getInstanceById, name, restriction) => {
-    const getName = (traditionId) => translateMap(getInstanceById("BlessedTradition", traditionId)?.translations)
-        ?.name;
+    const getName = (traditionId) => translateMap(getInstanceById("BlessedTradition", traditionId)?.translations)?.name;
     if (restriction.isSanctifiedBy) {
         switch (restriction.scope.kind) {
             case "Specific":
@@ -275,8 +266,8 @@ const renderBlessedTraditionRestriction = (translate, translateMap, localeJoin,
             case "Specific":
                 return translate("To buy a {$itemName} during hero creation, the character must have Tradition ({$traditions}).", {
                     itemName: name,
-                    traditions: localeJoin(restriction.scope.Specific.map(traditionId => translateMap(getInstanceById("BlessedTradition", traditionId)
-                        ?.translations)?.name).filter(isNotNullish), "disjunction"),
+                    traditions: localeJoin(restriction.scope.Specific.map(traditionId => translateMap(getInstanceById("BlessedTradition", traditionId)?.translations)
+                        ?.name).filter(isNotNullish), "disjunction"),
                 });
             case "Church":
                 return UNHANDLED_VALUE;
@@ -298,15 +289,13 @@ const renderMagicalTraditionRestriction = (translate, translateMap, getInstanceB
 const renderRaceRestriction = (translate, translateMap, getInstanceById, localeJoin, name, restriction) => translate("To buy a {$name} during hero creation, the character must be from a culture common to the race of {$races}.", {
     name,
     races: localeJoin(restriction.scope
-        .map(id => translateMap(getInstanceById("Race", id)?.translations)?.name ??
-        MISSING_VALUE)
+        .map(id => translateMap(getInstanceById("Race", id)?.translations)?.name ?? MISSING_VALUE)
         .filter(isNotNullish), "disjunction"),
 });
 const renderCultureRestriction = (translate, translateMap, getInstanceById, localeJoin, name, restriction) => translate("To buy a {$name} during hero creation, the character must be from the culture of the {$cultures}.", {
     name,
     cultures: localeJoin(restriction.scope
-        .map(id => translateMap(getInstanceById("Culture", id)?.translations)
-        ?.name ?? MISSING_VALUE)
+        .map(id => translateMap(getInstanceById("Culture", id)?.translations)?.name ?? MISSING_VALUE)
         .filter(isNotNullish), "disjunction"),
 });
 const renderProfessionRestriction = (_translate, _translateMap, _getInstanceById, _localeJoin, _name, _restriction) => UNHANDLED_VALUE;
@@ -361,8 +350,7 @@ const renderCost = (translate, translateMap, cost) => {
             }
             case "Indefinite": {
                 const translation = translateMap(bookCostVariant.Indefinite.translations);
-                return ((translation?.description ?? MISSING_VALUE) +
-                    parensIf(translation?.label));
+                return (translation?.description ?? MISSING_VALUE) + parensIf(translation?.label);
             }
             default:
                 return assertExhaustive(bookCostVariant);
@@ -421,11 +409,9 @@ const renderArmorValues = (translate, translateMap, localeCompare, getInstanceBy
     {
         label: translate("Additional Penalties"),
         value: values.has_additional_penalties
-            ? [
-                idMap.DerivedCharacteristic.Movement,
-                idMap.DerivedCharacteristic.Initiative,
-            ]
-                .map(dcId => `${sign(-1)} ${translateMap(getInstanceById("DerivedCharacteristic", dcId)?.translations)?.abbreviation ?? MISSING_VALUE}`)
+            ? [idMap.DerivedCharacteristic.Movement, idMap.DerivedCharacteristic.Initiative]
+                .map(dcId => `${sign(-1)} ${translateMap(getInstanceById("DerivedCharacteristic", dcId)?.translations)
+                ?.abbreviation ?? MISSING_VALUE}`)
                 .toSorted(localeCompare)
                 .join(", ")
             : "—",
@@ -470,7 +456,8 @@ const normalizeCombatValues = (entity) => {
         case "ToolOfTheTrade":
         case "TravelGearOrTool":
         case "Vehicle":
-        case "WeaponAccessory": {
+        case "WeaponAccessory":
+        case "WorkingSupernaturalCreature": {
             const baseItem = entity.content;
             if (baseItem.combat_use === undefined) {
                 return undefined;
@@ -499,9 +486,7 @@ const normalizeCombatValues = (entity) => {
  */
 export const getEquipmentEntityDescription = createEntityDescriptionCreator(({ getInstanceById, idMap }, locale, entry) => {
     const { translate, translateMap } = locale;
-    const translation = entry.entity === "ClothingPackage"
-        ? undefined
-        : translateMap(entry.content.translations);
+    const translation = entry.entity === "ClothingPackage" ? undefined : translateMap(entry.content.translations);
     if (entry.entity !== "ClothingPackage" && translation === undefined) {
         return undefined;
     }
@@ -537,36 +522,29 @@ export const getEquipmentEntityDescription = createEntityDescriptionCreator(({ g
                         label: translate("Color"),
                         value: color,
                     })),
-                    baseItemTranslation?.language !== undefined ||
-                        baseItemTranslation?.script !== undefined
+                    baseItemTranslation?.language !== undefined || baseItemTranslation?.script !== undefined
                         ? {
                             label: translate("Language/Script"),
-                            value: [
-                                baseItemTranslation?.language,
-                                baseItemTranslation?.script,
-                            ]
+                            value: [baseItemTranslation?.language, baseItemTranslation?.script]
                                 .map(value => value ?? "—")
                                 .join(" / "),
                         }
                         : undefined,
-                    baseItem.structure_points !== undefined &&
-                        isNotEmpty(baseItem.structure_points)
+                    baseItem.structure_points !== undefined && isNotEmpty(baseItem.structure_points)
                         ? {
                             label: translate("Structure Points"),
                             value: baseItem.structure_points.length === 1
-                                ? translate(".input {$value :number} {{{$value} Structure Points}}", { value: baseItem.structure_points[0].points })
+                                ? translate(".input {$value :number} {{{$value} Structure Points}}", {
+                                    value: baseItem.structure_points[0].points,
+                                })
                                 : translate("{$value} Structure Points", {
-                                    value: baseItem.structure_points
-                                        .map(elem => elem.points)
-                                        .join("/"),
+                                    value: baseItem.structure_points.map(elem => elem.points).join("/"),
                                 }),
                         }
                         : undefined,
                     mapNullable(baseItem.weight, weight => renderWeight(translate, locale.measurementAdjustments, weight)),
                     mapNullable(baseItem.cost, cost => renderCost(translate, translateMap, cost)),
-                    mapNullable(renderNote(translate, translateMap, getInstanceById, locale.join, combatValues?.type === "Weapon"
-                        ? combatValues.values.melee_uses
-                        : undefined, combatValues?.values.restrictedTo, name, baseItemTranslation?.note), note => ({
+                    mapNullable(renderNote(translate, translateMap, getInstanceById, locale.join, combatValues?.type === "Weapon" ? combatValues.values.melee_uses : undefined, combatValues?.values.restrictedTo, name, baseItemTranslation?.note), note => ({
                         label: translate("Note"),
                         value: note,
                     })),
@@ -576,34 +554,48 @@ export const getEquipmentEntityDescription = createEntityDescriptionCreator(({ g
                             value: baseItemTranslation.rules,
                         }
                         : undefined,
-                    combatValues?.type === "Weapon" &&
-                        combatTranslation?.advantage !== undefined
+                    combatValues?.type === "Weapon" && combatTranslation?.advantage !== undefined
                         ? {
                             label: translate("Weapon Advantage"),
                             value: combatTranslation.advantage,
                         }
                         : undefined,
-                    combatValues?.type === "Weapon" &&
-                        combatTranslation?.disadvantage !== undefined
+                    combatValues?.type === "Weapon" && combatTranslation?.disadvantage !== undefined
                         ? {
                             label: translate("Weapon Disadvantage"),
                             value: combatTranslation.disadvantage,
                         }
                         : undefined,
-                    combatValues?.type === "Armor" &&
-                        combatTranslation?.advantage !== undefined
+                    combatValues?.type === "Armor" && combatTranslation?.advantage !== undefined
                         ? {
                             label: translate("Armor Advantage"),
                             value: combatTranslation.advantage,
                         }
                         : undefined,
-                    combatValues?.type === "Armor" &&
-                        combatTranslation?.disadvantage !== undefined
+                    combatValues?.type === "Armor" && combatTranslation?.disadvantage !== undefined
                         ? {
                             label: translate("Armor Disadvantage"),
                             value: combatTranslation.disadvantage,
                         }
                         : undefined,
+                    baseItemTranslation?.appearance !== undefined
+                        ? {
+                            label: translate("Appearance"),
+                            value: baseItemTranslation.appearance,
+                        }
+                        : undefined,
+                    baseItemTranslation?.appearance !== undefined
+                        ? {
+                            label: translate("Components"),
+                            value: baseItemTranslation.components,
+                        }
+                        : undefined,
+                    baseItemTranslation?.appearance !== undefined
+                        ? {
+                            label: translate("Use"),
+                            value: baseItemTranslation.use,
+                        }
+                        : undefined,
                 ],
             },
         ],

package/lib/entities/equipmentPackage.js

@@ -1,6 +1,6 @@
 import { on } from "@elyukai/utils/function";
 import { assertExhaustive } from "@elyukai/utils/typeSafety";
-import { createEntityDescriptionCreator, } from "../creator.js";
+import { createEntityDescriptionCreator } from "../creator.js";
 import { getEquipmentName } from "./equipment.js";
 const sumAtomicEquipmentCost = (acc, current) => {
     if (typeof acc === "string") {
@@ -49,10 +49,7 @@ const rangeAtomicEquipmentCost = (acc, current) => {
     }
     const normAcc = typeof acc === "number" ? [acc, acc] : acc;
     const normCurrent = typeof current === "number" ? [current, current] : current;
-    return [
-        Math.min(normAcc[0], normCurrent[0]),
-        Math.max(normAcc[1], normCurrent[1]),
-    ];
+    return [Math.min(normAcc[0], normCurrent[0]), Math.max(normAcc[1], normCurrent[1])];
 };
 const getAtomicCost = (cost) => {
     switch (cost.kind) {
@@ -147,14 +144,13 @@ const getAtomicEquipmentCost = (entry) => {
         case "Vehicle":
         case "Weapon":
         case "WeaponAccessory":
+        case "WorkingSupernaturalCreature":
             return getAtomicCost(entry.content.cost);
         case "Elixir":
-            return [
-                entry.content.cost_per_ingredient_level,
-                entry.content.cost_per_ingredient_level * 6,
-            ];
+            return [entry.content.cost_per_ingredient_level, entry.content.cost_per_ingredient_level * 6];
         case "Poison":
-            switch (entry.content.cost.kind) {
+            switch (entry.content.cost?.kind) {
+                case undefined:
                 case "CannotBeExtracted":
                 case "None":
                     return 0;
@@ -162,6 +158,8 @@ const getAtomicEquipmentCost = (entry) => {
                     return entry.content.cost.Constant;
                 case "Indefinite":
                     return "Various";
+                case "DependingOnPurchaseOrSale":
+                    return entry.content.cost.DependingOnPurchaseOrSale.purchase;
                 default:
                     return assertExhaustive(entry.content.cost);
             }
@@ -178,6 +176,7 @@ const getAtomicEquipmentWeight = (entry) => {
         case "EquipmentOfBlessedOnes":
         case "Newspaper":
         case "Poison":
+        case "WorkingSupernaturalCreature":
             return 0;
         case "AnimalCare":
             switch (entry.content.type.kind) {

package/lib/entities/influence.d.ts

@@ -1,7 +1,11 @@
-import type { GetInstanceById } from "../helpers/getTypes.js";
+import type { ActivatableIdentifier } from "optolith-database-schema/gen";
+import type { GetAllChildInstancesForParent, GetInstanceById } from "../helpers/getTypes.js";
+import type { GetResolvedSelectOptionById } from "./partial/prerequisites/single/activatable.js";
 /**
  * Get a JSON representation of the rules text for an influence.
  */
 export declare const getInfluenceEntityDescription: import("../creator.js").EntityDescriptionCreator<"Influence", {
-    getInstanceById: GetInstanceById<"Publication" | "Influence">;
+    getInstanceById: GetInstanceById<"Publication" | "Influence" | "Race" | ActivatableIdentifier["kind"] | "Aspect">;
+    getResolvedSelectOptionById: GetResolvedSelectOptionById;
+    getChildInstancesForInstanceId: GetAllChildInstancesForParent<"ProfessionVersion">;
 }, import("../index.js").EntityDescription>;

package/lib/entities/influence.js

@@ -3,7 +3,7 @@ import { printInfluencePrerequisites } from "./partial/prerequisites/index.js";
 /**
  * Get a JSON representation of the rules text for an influence.
  */
-export const getInfluenceEntityDescription = createEntityDescriptionCreator(({ getInstanceById }, locale, { content: entry }) => {
+export const getInfluenceEntityDescription = createEntityDescriptionCreator(({ getInstanceById, getResolvedSelectOptionById, getChildInstancesForInstanceId }, locale, { content: entry }) => {
     const { translate, translateMap } = locale;
     const translation = translateMap(entry.translations);
     if (translation === undefined) {
@@ -13,21 +13,29 @@ export const getInfluenceEntityDescription = createEntityDescriptionCreator(({ g
         title: translation.name,
         className: "influence",
         body: [
-            {
-                type: "definitionList",
-                items: [
-                    ...(translation.effects?.map(effect => ({
-                        label: effect.label,
-                        value: effect.text,
-                    })) ?? []),
-                    entry.prerequisites === undefined
-                        ? undefined
-                        : {
-                            label: translate("Prerequisites"),
-                            value: printInfluencePrerequisites(getInstanceById, locale, entry.prerequisites),
-                        },
-                ],
-            },
+            translation.rules === undefined
+                ? undefined
+                : {
+                    type: "plain",
+                    text: translation.rules,
+                },
+            translation.effects === undefined || translation.effects.length === 0
+                ? undefined
+                : {
+                    type: "definitionList",
+                    items: [
+                        ...(translation.effects?.map(effect => ({
+                            label: effect.label,
+                            value: effect.text,
+                        })) ?? []),
+                        entry.prerequisites === undefined
+                            ? undefined
+                            : {
+                                label: translate("Prerequisites"),
+                                value: printInfluencePrerequisites(getInstanceById, getResolvedSelectOptionById, getChildInstancesForInstanceId, locale, entry.prerequisites),
+                            },
+                    ],
+                },
         ],
         errata: translation.errata,
         references: entry.src,

package/lib/entities/liturgicalChant.d.ts

@@ -1,4 +1,5 @@
-import type { GetInstanceById } from "../helpers/getTypes.js";
+import { type RatedIdentifier } from "optolith-database-schema/gen";
+import type { GetAllChildInstancesForParent, GetInstanceById } from "../helpers/getTypes.js";
 import { type IdMap } from "../index.js";
 /**
  * Get a JSON representation of the rules text for a blessing.
@@ -10,13 +11,15 @@ export declare const getBlessingEntityDescription: import("../creator.js").Entit
  * Get a JSON representation of the rules text for a liturgical chant.
  */
 export declare const getLiturgicalChantEntityDescription: import("../creator.js").EntityDescriptionCreator<"LiturgicalChant", {
-    getInstanceById: GetInstanceById<"Publication" | "Attribute" | "SkillModificationLevel" | "TargetCategory" | "Aspect" | "BlessedTradition" | "DerivedCharacteristic">;
+    getInstanceById: GetInstanceById<"Publication" | "Attribute" | "SkillModificationLevel" | "TargetCategory" | "Aspect" | "BlessedTradition" | "DerivedCharacteristic" | RatedIdentifier["kind"] | "Enhancement">;
+    getChildInstancesForInstanceId: GetAllChildInstancesForParent<"Enhancement">;
     idMap: IdMap;
 }, import("../index.js").EntityDescription>;
 /**
  * Get a JSON representation of the rules text for a ceremony.
  */
 export declare const getCeremonyEntityDescription: import("../creator.js").EntityDescriptionCreator<"Ceremony", {
-    getInstanceById: GetInstanceById<"Publication" | "Attribute" | "SkillModificationLevel" | "TargetCategory" | "Aspect" | "BlessedTradition" | "DerivedCharacteristic">;
+    getInstanceById: GetInstanceById<"Publication" | "Attribute" | "SkillModificationLevel" | "TargetCategory" | "Aspect" | "BlessedTradition" | "DerivedCharacteristic" | RatedIdentifier["kind"] | "Enhancement">;
+    getChildInstancesForInstanceId: GetAllChildInstancesForParent<"Enhancement">;
     idMap: IdMap;
 }, import("../index.js").EntityDescription>;

package/lib/entities/liturgicalChant.js

@@ -1,6 +1,8 @@
 import { isNotNullish } from "@optolith/helpers/nullable";
 import { assertExhaustive } from "@optolith/helpers/typeSafety";
+import { Case } from "tsondb/schema/gen";
 import { createEntityDescriptionCreator } from "../creator.js";
+import { renderEnhancements } from "./partial/enhancements.js";
 import { renderOneTimeDuration } from "./partial/rated/activatable/duration.js";
 import { renderEffect } from "./partial/rated/activatable/effect.js";
 import { renderFastPerformanceParameters, renderSlowPerformanceParameters, } from "./partial/rated/activatable/index.js";
@@ -11,16 +13,14 @@ import { renderImprovementCost } from "./partial/rated/improvementCost.js";
 import { renderSkillCheckWithPenalty } from "./partial/rated/skillCheck.js";
 import { ResponsiveTextSize } from "./partial/responsiveText.js";
 const getTextForTraditions = (deps, values) => {
-    const getAspectName = (aspectId) => deps.translateMap(deps.getInstanceById("Aspect", aspectId)?.translations)
-        ?.name;
+    const getAspectName = (aspectId) => deps.translateMap(deps.getInstanceById("Aspect", aspectId)?.translations)?.name;
     const text = values
         .map(trad => {
         switch (trad.kind) {
             case "GeneralAspect":
                 return getAspectName(trad.GeneralAspect);
             case "Tradition": {
-                const traditionTranslation = deps.translateMap(deps.getInstanceById("BlessedTradition", trad.Tradition.tradition)
-                    ?.translations);
+                const traditionTranslation = deps.translateMap(deps.getInstanceById("BlessedTradition", trad.Tradition.tradition)?.translations);
                 const name = traditionTranslation?.name_compressed ?? traditionTranslation?.name;
                 if (name === undefined) {
                     return undefined;
@@ -75,9 +75,7 @@ export const getBlessingEntityDescription = createEntityDescriptionCreator(({ ge
                     },
                     {
                         label: translate("Range"),
-                        value: range !== translation.range
-                            ? `***${range}*** (${translation.range})`
-                            : range,
+                        value: range !== translation.range ? `***${range}*** (${translation.range})` : range,
                     },
                     {
                         label: translate("Duration"),
@@ -96,7 +94,7 @@ export const getBlessingEntityDescription = createEntityDescriptionCreator(({ ge
 /**
  * Get a JSON representation of the rules text for a liturgical chant.
  */
-export const getLiturgicalChantEntityDescription = createEntityDescriptionCreator(({ getInstanceById, idMap }, locale, { content: entry }) => {
+export const getLiturgicalChantEntityDescription = createEntityDescriptionCreator(({ getInstanceById, getChildInstancesForInstanceId, idMap }, locale, { content: entry, entity, id }) => {
     const { translate, translateMap, compare: localeCompare } = locale;
     const translation = translateMap(entry.translations);
     if (translation === undefined) {
@@ -106,7 +104,9 @@ export const getLiturgicalChantEntityDescription = createEntityDescriptionCreato
         translate,
         translateMap,
         getInstanceById,
+        getChildInstancesForInstanceId,
         localeJoin: locale.join,
+        localeCompare: locale.compare,
         energyUnit: "KarmaPoints",
         responsiveTextSize: ResponsiveTextSize.Full,
         nonModifiableSuffix: (param) => {
@@ -134,8 +134,7 @@ export const getLiturgicalChantEntityDescription = createEntityDescriptionCreato
                     renderEffect(translation.effect).run(env),
                     {
                         label: translate("Liturgical Time"),
-                        value: translation.casting_time &&
-                            castingTime !== translation.casting_time.full
+                        value: translation.casting_time && castingTime !== translation.casting_time.full
                             ? `***${castingTime}*** (${translation.casting_time.full})`
                             : castingTime,
                     },
@@ -167,6 +166,7 @@ export const getLiturgicalChantEntityDescription = createEntityDescriptionCreato
                     renderImprovementCost(entry.improvement_cost).run(env),
                 ],
             },
+            renderEnhancements(Case(entity, id), entry.improvement_cost).run(env),
         ],
         errata: translation.errata,
         references: entry.src,
@@ -175,7 +175,7 @@ export const getLiturgicalChantEntityDescription = createEntityDescriptionCreato
 /**
  * Get a JSON representation of the rules text for a ceremony.
  */
-export const getCeremonyEntityDescription = createEntityDescriptionCreator(({ getInstanceById, idMap }, locale, { content: entry }) => {
+export const getCeremonyEntityDescription = createEntityDescriptionCreator(({ getInstanceById, getChildInstancesForInstanceId, idMap }, locale, { content: entry, entity, id }) => {
     const { translate, translateMap, compare: localeCompare } = locale;
     const translation = translateMap(entry.translations);
     if (translation === undefined) {
@@ -185,7 +185,9 @@ export const getCeremonyEntityDescription = createEntityDescriptionCreator(({ ge
         translate,
         translateMap,
         getInstanceById,
+        getChildInstancesForInstanceId,
         localeJoin: locale.join,
+        localeCompare: locale.compare,
         energyUnit: "KarmaPoints",
         responsiveTextSize: ResponsiveTextSize.Full,
         nonModifiableSuffix: (param) => {
@@ -213,8 +215,7 @@ export const getCeremonyEntityDescription = createEntityDescriptionCreator(({ ge
                     renderEffect(translation.effect).run(env),
                     {
                         label: translate("Ceremonial Time"),
-                        value: translation.casting_time &&
-                            castingTime !== translation.casting_time.full
+                        value: translation.casting_time && castingTime !== translation.casting_time.full
                             ? `***${castingTime}*** (${translation.casting_time.full})`
                             : castingTime,
                     },
@@ -246,6 +247,7 @@ export const getCeremonyEntityDescription = createEntityDescriptionCreator(({ ge
                     renderImprovementCost(entry.improvement_cost).run(env),
                 ],
             },
+            renderEnhancements(Case(entity, id), entry.improvement_cost).run(env),
         ],
         errata: translation.errata,
         references: entry.src,

package/lib/entities/partial/enhancements.d.ts

@@ -0,0 +1,7 @@
+import { RatedIdentifier, type ImprovementCost, type SkillWithEnhancementsIdentifier } from "optolith-database-schema/gen";
+import type { RawEntityDescriptionSection } from "../../index.js";
+import { type StdReader } from "./reader.js";
+/**
+ * Render the enhancements section for an entity description, if applicable.
+ */
+export declare const renderEnhancements: (parentId: SkillWithEnhancementsIdentifier, parentImprovementCost: ImprovementCost) => StdReader<RawEntityDescriptionSection | undefined, "t" | "tm" | "lc" | "lj" | "ibi" | "acibp", RatedIdentifier["kind"] | "Enhancement", "Enhancement">;

package/lib/entities/partial/enhancements.js

@@ -0,0 +1,26 @@
+import { on } from "@elyukai/utils/function";
+import { isNotNullish } from "@elyukai/utils/nullable";
+import { compareNumber } from "@elyukai/utils/ordering";
+import { Reader } from "@elyukai/utils/reader";
+import { getAdventurePointsForActivation } from "@optolith/adventure-points/improvement-cost";
+import { printEnhancementPrerequisites } from "./prerequisites/index.js";
+import { getChildInstancesForInstanceIdR, translateMapR, translateR, } from "./reader.js";
+/**
+ * Render the enhancements section for an entity description, if applicable.
+ */
+export const renderEnhancements = (parentId, parentImprovementCost) => getChildInstancesForInstanceIdR("Enhancement", parentId).thenW(enhancements => Reader.traverse(enhancements.toSorted(on(e => e.content.skill_rating, compareNumber)), enhancement => translateMapR(enhancement.content.translations).thenW(translation => Reader.ask().map(env => translation === undefined
+    ? undefined
+    : `- ^[${translation.name}](entity: "Enhancement") (${env.translate("SR {$value}", { value: enhancement.content.skill_rating })}, ${env.translate("{$value} AP", { value: enhancement.content.adventure_points_modifier * getAdventurePointsForActivation(parentImprovementCost.kind) })}): ${translation.effect ?? ""}${enhancement.content.prerequisites === undefined ? "" : ` ${env.translate(".input {$hiddenCount :number} {{Prerequisites}}", { hiddenCount: enhancement.content.prerequisites.length })}: ${printEnhancementPrerequisites(env.getInstanceById, { translate: env.translate, translateMap: env.translateMap, compare: env.localeCompare, join: env.localeJoin }, enhancement.content.prerequisites)}`}`))).thenW(enhancementDescriptions => {
+    const nonNullishDescriptions = enhancementDescriptions.filter(isNotNullish);
+    if (nonNullishDescriptions.length === 0) {
+        return Reader.of(undefined);
+    }
+    return translateR("Enhancements").map((label) => ({
+        type: "labeled",
+        label,
+        value: {
+            type: "plain",
+            text: nonNullishDescriptions.join("\n"),
+        },
+    }));
+}));

package/lib/entities/partial/prerequisites/index.d.ts

@@ -1,5 +1,5 @@
 import { AdvantageDisadvantagePrerequisites, AnimistPowerPrerequisites, ArcaneTraditionPrerequisites, DerivedCharacteristicPrerequisites, EnhancementPrerequisites, GeneralPrerequisites, GeodeRitualPrerequisites, InfluencePrerequisites, LanguagePrerequisites, LiturgyPrerequisites, PersonalityTraitPrerequisites, PlainGeneralPrerequisites, ProfessionPrerequisites, PublicationPrerequisites, SpecialAbilityIdentifier, SpellworkPrerequisites, type ActivatableIdentifier, type RatedIdentifier } from "optolith-database-schema/gen";
-import type { GetInstanceById } from "../../../helpers/getTypes.js";
+import type { GetAllChildInstancesForParent, GetInstanceById } from "../../../helpers/getTypes.js";
 import { LocaleEnvironment } from "../../../helpers/locale.js";
 import { GetResolvedSelectOptionById } from "./single/activatable.js";
 /**
@@ -48,7 +48,7 @@ export declare const printLiturgyPrerequisites: (locale: LocaleEnvironment, valu
 /**
  * Print influence prerequisites as a string.
  */
-export declare const printInfluencePrerequisites: (getInstanceById: GetInstanceById<"Influence">, locale: LocaleEnvironment, value: InfluencePrerequisites) => string;
+export declare const printInfluencePrerequisites: (getInstanceById: GetInstanceById<"Influence" | "Race" | ActivatableIdentifier["kind"] | "Aspect">, getResolvedSelectOptionById: GetResolvedSelectOptionById, getChildInstancesForInstanceId: GetAllChildInstancesForParent<"ProfessionVersion">, locale: LocaleEnvironment, value: InfluencePrerequisites) => string;
 /**
  * Print language prerequisites as a string.
  */
@@ -64,4 +64,4 @@ export declare const printGeodeRitualPrerequisites: (getInstanceById: GetInstanc
 /**
  * Print enhancement prerequisites as a string.
  */
-export declare const printEnhancementPrerequisites: (getInstanceById: GetInstanceById<RatedIdentifier["kind"] | "Enhancement">, locale: LocaleEnvironment, value: EnhancementPrerequisites) => string;
+export declare const printEnhancementPrerequisites: (getInstanceById: GetInstanceById<RatedIdentifier["kind"] | "Enhancement">, locale: Pick<LocaleEnvironment, "translate" | "translateMap" | "compare" | "join">, value: EnhancementPrerequisites) => string;