@optolith/entity-descriptions 0.4.0 → 0.4.1

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

@@ -2,24 +2,24 @@ import { Reader } from "@elyukai/utils/reader";
 import { mapNullable } from "@optolith/helpers/nullable";
 import { assertExhaustive } from "@optolith/helpers/typeSafety";
 import { getInstanceByIdFnR, modifiableBySpeedOptionalR, modifiableBySpeedR, translateFnR, translateMapR, translateR, } from "../../reader.js";
-import { appendNoteIfNeeded, replaceTextIfNeeded, } from "../../responsiveText.js";
+import { appendNoteIfNeeded, replaceTextIfNeeded } from "../../responsiveText.js";
 import { formatCombinedLengthR, formatLengthR } from "../../units/length.js";
 import { MISSING_VALUE } from "../../unknown.js";
 import { renderCheckResultBasedValue } from "./checkResultBased.js";
 import { wrapIfMaximum } from "./isMinimumMaximum.js";
-import { appendNonModifiableSuffix, ModifiableParameter, } from "./nonModifiableSuffix.js";
+import { appendNonModifiableSuffix, ModifiableParameter } from "./nonModifiableSuffix.js";
 const deriveModifiableRange = (modificationLevelId) => getInstanceByIdFnR().thenW(getInstanceById => mapNullable(getInstanceById("SkillModificationLevel", modificationLevelId), modificationLevel => modifiableBySpeedR("range", modificationLevel).thenW(value => translateMapR(modificationLevel.translations).thenW(translation => translation === undefined
     ? Reader.of({ value, translation: undefined })
     : modifiableBySpeedOptionalR("range", translation).map(valueTranslation => ({
         value,
         translation: valueTranslation,
     }))))) ?? Reader.of(undefined));
-const wrapIfRadius = (is_radius, text) => translateFnR.map(translate => is_radius === true ? `${text} ${translate("Radius")}` : text);
+const wrapIfRadius = (is_radius, text) => translateFnR.map(translate => (is_radius === true ? `${text} ${translate("Radius")}` : text));
 const renderModifiableRange = (value) => deriveModifiableRange(value.initial_modification_level)
     .thenW(range => range === undefined
     ? Reader.of(MISSING_VALUE)
-    : typeof range === "string"
-        ? Reader.of(range)
+    : range.translation !== undefined
+        ? Reader.of(range.translation)
         : formatLengthR("Steps", range.value))
     .then(text => wrapIfRadius(value.is_radius, text))
     .then(text => wrapIfMaximum(value.is_maximum, text));
@@ -36,7 +36,7 @@ const getCheckResultBasedRangeTranslation = (value) => renderCheckResultBasedVal
 export const renderNonModifiableRange = (value, shouldAppendNonModifiableSuffix) => {
     const appendNonModifiableSuffixIfNeeded = shouldAppendNonModifiableSuffix
         ? (text) => appendNonModifiableSuffix(ModifiableParameter.Range, text)
-        : Reader.of;
+        : (text) => Reader.of(text);
     switch (value.kind) {
         case "Sight":
             return translateR("Sight");

package/lib/entities/partial/rated/activatable/speed.d.ts

@@ -1,4 +1,4 @@
-import { FastSkillModificationLevelConfig, SkillModificationLevel, SlowSkillModificationLevelConfig } from "optolith-database-schema/gen";
+import type { FastSkillModificationLevelConfig, SkillModificationLevel, SlowSkillModificationLevelConfig } from "optolith-database-schema/gen";
 /**
  * The speed of an activatable skill.
  */

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

@@ -1,7 +1,7 @@
 import { Reader } from "@elyukai/utils/reader";
 import { mapNullable } from "@optolith/helpers/nullable";
 import { assertExhaustive } from "@optolith/helpers/typeSafety";
-import { getInstanceByIdFnR, translateMapR, translateR, } from "../../reader.js";
+import { getInstanceByIdFnR, translateMapR, translateR } from "../../reader.js";
 import { MISSING_VALUE } from "../../unknown.js";
 import { appendInParensIfNotEmpty } from "./parensIf.js";
 const renderPredefined = (targetCategoryId) => getInstanceByIdFnR()
@@ -32,4 +32,4 @@ export const renderTargetCategory = (values) => translateR("Target Category").th
     ? translateR("all")
     : Reader.sequence(values.map(({ id, translations }) => getTargetCategoryTranslationByType(id).then(text => translateMapR(translations)
         .map(translation => translation?.note)
-        .map(note => appendInParensIfNotEmpty(note, text)) ?? text))).map(texts => texts.join(", "))).map(value => ({ label, value })));
+        .map(note => appendInParensIfNotEmpty(note, text))))).map(texts => texts.join(", "))).map(value => ({ label, value })));

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

@@ -2,7 +2,7 @@ import { Reader } from "@elyukai/utils/reader";
 import type { ChildEntityMap, EntityMap, FastSkillModificationLevelConfig, ResponsiveText, ResponsiveTextOptional, SkillModificationLevel, SlowSkillModificationLevelConfig } from "optolith-database-schema/gen";
 import type { IdArgsVariant } from "tsondb/schema/gen";
 import type { GetAllChildInstancesForParent, GetAllInstances, GetInstanceById } from "../../helpers/getTypes.js";
-import type { LocaleCompare, LocaleJoin, LocaleJoinType } from "../../helpers/locale.js";
+import type { FormatNumber, LocaleCompare, LocaleJoin, LocaleJoinType } from "../../helpers/locale.js";
 import type { Format, LocaleMap, Translate, TranslateMap, TranslationKeyMatchingParamsOfKey, TranslationKeysWithoutParams, TranslationParamsInArray, Translations } from "../../helpers/translate.js";
 import type { GetResolvedSelectOptionById } from "./prerequisites/single/activatable.js";
 import type { ModifiableParameter } from "./rated/activatable/nonModifiableSuffix.js";
@@ -14,6 +14,7 @@ import { type EnergyUnit } from "./units/energy.js";
  */
 export type EnvMap<E extends keyof EntityMap = never, AE extends keyof EntityMap = never, CE extends keyof ChildEntityMap = never> = {
     format: Format;
+    formatNumber: FormatNumber;
     translate: Translate;
     translateMap: TranslateMap;
     localeJoin: LocaleJoin;
@@ -32,6 +33,7 @@ export type EnvMap<E extends keyof EntityMap = never, AE extends keyof EntityMap
  */
 export type EnvMapAbbr = {
     f: "format";
+    fn: "formatNumber";
     t: "translate";
     tm: "translateMap";
     lj: "localeJoin";
@@ -60,7 +62,7 @@ export type StdReader<T, K extends keyof EnvMapAbbr, E extends keyof EntityMap =
 /**
  * Treats the text as a translation string and applies supplied arguments.
  */
-export declare const formatR: (text: string, args?: Record<string, unknown> | undefined) => Reader<{
+export declare const formatR: (text: string, args?: Record<string, unknown>) => Reader<{
     format: Format;
 }, string>;
 /**

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

@@ -29,7 +29,11 @@ export declare const getResponsiveTextOptional: (value: ResponsiveTextOptional |
  */
 export declare const replaceTextIfNeeded: (translations: LocaleMap<{
     replacement?: ResponsiveTextReplace;
-}> | undefined, valueToReplace: string) => Reader<StdEnv<"rts" | "tm">, string>;
+}> | undefined, valueToReplace: string, differentValueToInsert?: string) => Reader<{
+    translateMap: import("../../helpers/translate.js").TranslateMap;
+} & {
+    responsiveTextSize: ResponsiveTextSize;
+}, string>;
 /**
  * Appends a note to a given value if a note is requested, otherwise just return
  * the given value.

package/lib/entities/partial/responsiveText.js

@@ -2,7 +2,7 @@ import { identity } from "@elyukai/utils/function";
 import { Reader } from "@elyukai/utils/reader";
 import { assertExhaustive } from "@optolith/helpers/typeSafety";
 import { appendInParensIfNotEmpty } from "./rated/activatable/parensIf.js";
-import { responsiveTextOptionalR, responsiveTextR, translateMapR, } from "./reader.js";
+import { responsiveTextOptionalR, responsiveTextR, translateMapR } from "./reader.js";
 import { MISSING_VALUE } from "./unknown.js";
 /**
  * Whether the entry is displayed in a normal or compressed setting. Normal/full
@@ -49,13 +49,11 @@ export const getResponsiveTextOptional = (value, size) => {
  * Replaces a text with a given value if a replacement is requested, otherwise
  * just return the given value.
  */
-export const replaceTextIfNeeded = (translations, valueToReplace) => translateMapR(translations)
-    .with(identity)
-    .then(translation => {
+export const replaceTextIfNeeded = (translations, valueToReplace, differentValueToInsert = valueToReplace) => translateMapR(translations).thenW(translation => {
     if (translation?.replacement === undefined) {
         return Reader.of(valueToReplace);
     }
-    return responsiveTextR(translation.replacement).map(note => note.replace("$1", valueToReplace));
+    return responsiveTextR(translation.replacement).map(note => note.replace("$1", differentValueToInsert));
 });
 /**
  * Appends a note to a given value if a note is requested, otherwise just return

package/lib/entities/partial/units/length.d.ts

@@ -1,6 +1,6 @@
 import type { Translate } from "../../../helpers/translate.js";
 import type { StdReader } from "../reader.js";
-import { ResponsiveTextSize } from "../responsiveText.js";
+import { type ResponsiveTextSize } from "../responsiveText.js";
 type LengthUnit = "Steps" | "Miles";
 /**
  * Returns the text for a length unit.

package/lib/entities/partial/units/length.js

@@ -1,16 +1,8 @@
 import { Reader } from "@elyukai/utils/reader";
 import { responsive } from "../responsiveText.js";
 const lengthUnitTranslationKeys = {
-    Steps: [
-        ".input {$value :number} {{{$value} yards}}",
-        "{$value} yards",
-        "{$value} yd",
-    ],
-    Miles: [
-        ".input {$value :number} {{{$value} miles}}",
-        "{$value} miles",
-        "{$value} mi.",
-    ],
+    Steps: [".input {$value :number} {{{$value} yards}}", "{$value} yards", "{$value} yd"],
+    Miles: [".input {$value :number} {{{$value} miles}}", "{$value} miles", "{$value} mi."],
 };
 /**
  * Returns the text for a length unit.

package/lib/entities/partial/units/timeSpan.d.ts

@@ -1,7 +1,7 @@
 import { Reader } from "@elyukai/utils/reader";
 import type { Translate } from "../../../helpers/translate.js";
 import type { StdEnv } from "../reader.js";
-import { ResponsiveTextSize } from "../responsiveText.js";
+import { type ResponsiveTextSize } from "../responsiveText.js";
 /**
  * Possible units to use for time spans.
  */
@@ -11,13 +11,13 @@ export type TimeSpanUnit = "Seconds" | "Minutes" | "Hours" | "Days" | "Weeks" |
  */
 export declare const formatTimeSpan: (translate: Translate, responsiveTextSize: ResponsiveTextSize, unit: {
     kind: TimeSpanUnit;
-} | TimeSpanUnit, value: number | string) => string;
+} | TimeSpanUnit, value: number | string, interval?: boolean) => string;
 /**
  * Returns the text for a time span unit.
  */
 export declare const formatTimeSpanR: (unit: {
     kind: TimeSpanUnit;
-} | TimeSpanUnit, value: number | string) => Reader<StdEnv<"t" | "rts">, string>;
+} | TimeSpanUnit, value: number | string, interval?: boolean) => Reader<StdEnv<"t" | "rts">, string>;
 /**
  * Returns the text for a time span unit.
  */
@@ -26,4 +26,4 @@ export declare const formatCombinedTimeSpanR: (object: {
         kind: TimeSpanUnit;
     };
     value: number | string;
-}) => Reader<StdEnv<"t" | "rts">, string>;
+}, interval?: boolean) => Reader<StdEnv<"t" | "rts">, string>;

package/lib/entities/partial/units/timeSpan.js

@@ -2,33 +2,37 @@ import { Reader } from "@elyukai/utils/reader";
 import { responsive } from "../responsiveText.js";
 // prettier-ignore
 const timeSpanUnitTranslationKeys = {
-    Seconds: [".input {$value :number} {{{$value} seconds}}", "{$value} seconds", "{$value} s"],
-    Minutes: [".input {$value :number} {{{$value} minutes}}", "{$value} minutes", "{$value} min"],
-    Hours: [".input {$value :number} {{{$value} hours}}", "{$value} hours", "{$value} h"],
-    Days: [".input {$value :number} {{{$value} days}}", "{$value} days", "{$value} d"],
-    Weeks: [".input {$value :number} {{{$value} weeks}}", "{$value} weeks", ".input {$value :number} {{{$value} wks.}}"],
-    Months: [".input {$value :number} {{{$value} months}}", "{$value} months", ".input {$value :number} {{{$value} mos.}}"],
-    Years: [".input {$value :number} {{{$value} years}}", "{$value} years", ".input {$value :number} {{{$value} yrs.}}"],
-    Centuries: [".input {$value :number} {{{$value} centuries}}", "{$value} centuries", "{$value} cent."],
-    Actions: [".input {$value :number} {{{$value} actions}}", "{$value} actions", "{$value} act"],
-    CombatRounds: [".input {$value :number} {{{$value} combat rounds}}", "{$value} combat rounds", "{$value} CR"],
-    SeductionActions: [".input {$value :number} {{{$value} seduction actions}}", "{$value} seduction actions", "{$value} SA"],
-    Rounds: [".input {$value :number} {{{$value} rounds}}", "{$value} rounds", "{$value} rnds"],
+    Seconds: [".input {$value :number} .input {$style :string} {{{$value} seconds}}", "{$value} seconds", ".input {$value :number} .input {$style :string} {{{$value} s}}", "{$value} s"],
+    Minutes: [".input {$value :number} .input {$style :string} {{{$value} minutes}}", "{$value} minutes", ".input {$value :number} .input {$style :string} {{{$value} min}}", "{$value} min"],
+    Hours: [".input {$value :number} .input {$style :string} {{{$value} hours}}", "{$value} hours", ".input {$value :number} .input {$style :string} {{{$value} h}}", "{$value} h"],
+    Days: [".input {$value :number} .input {$style :string} {{{$value} days}}", "{$value} days", ".input {$value :number} .input {$style :string} {{{$value} d}}", "{$value} d"],
+    Weeks: [".input {$value :number} .input {$style :string} {{{$value} weeks}}", "{$value} weeks", ".input {$value :number} .input {$style :string} {{{$value} wks.}}", "{$value} wks."],
+    Months: [".input {$value :number} .input {$style :string} {{{$value} months}}", "{$value} months", ".input {$value :number} .input {$style :string} {{{$value} mos.}}", "{$value} mos."],
+    Years: [".input {$value :number} .input {$style :string} {{{$value} years}}", "{$value} years", ".input {$value :number} .input {$style :string} {{{$value} yrs.}}", "{$value} yrs."],
+    Centuries: [".input {$value :number} .input {$style :string} {{{$value} centuries}}", "{$value} centuries", ".input {$value :number} .input {$style :string} {{{$value} cent.}}", "{$value} cent."],
+    Actions: [".input {$value :number} .input {$style :string} {{{$value} actions}}", "{$value} actions", ".input {$value :number} .input {$style :string} {{{$value} act}}", "{$value} act"],
+    CombatRounds: [".input {$value :number} .input {$style :string} {{{$value} combat rounds}}", "{$value} combat rounds", ".input {$value :number} .input {$style :string} {{{$value} CR}}", "{$value} CR"],
+    SeductionActions: [".input {$value :number} .input {$style :string} {{{$value} seduction actions}}", "{$value} seduction actions", ".input {$value :number} .input {$style :string} {{{$value} SA}}", "{$value} SA"],
+    Rounds: [".input {$value :number} .input {$style :string} {{{$value} rounds}}", "{$value} rounds", ".input {$value :number} .input {$style :string} {{{$value} rnds}}", "{$value} rnds"],
 };
 /**
  * Returns the text for a time span unit.
  */
-export const formatTimeSpan = (translate, responsiveTextSize, unit, value) => {
-    const [fullNumberKey, fullKey, compressedKey] = timeSpanUnitTranslationKeys[typeof unit === "string" ? unit : unit.kind];
+export const formatTimeSpan = (translate, responsiveTextSize, unit, value, interval = false) => {
+    const [fullNumberKey, fullKey, compressedNumberKey, compressedKey] = timeSpanUnitTranslationKeys[typeof unit === "string" ? unit : unit.kind];
     return responsive(responsiveTextSize, () => translate(typeof value === "number" ? fullNumberKey : fullKey, {
         value,
-    }), () => translate(compressedKey, { value }));
+        style: interval ? "interval" : "default",
+    }), () => translate(typeof value === "number" ? compressedNumberKey : compressedKey, {
+        value,
+        style: interval ? "interval" : "default",
+    }));
 };
 /**
  * Returns the text for a time span unit.
  */
-export const formatTimeSpanR = (unit, value) => Reader.asks(({ translate, responsiveTextSize }) => formatTimeSpan(translate, responsiveTextSize, unit, value));
+export const formatTimeSpanR = (unit, value, interval) => Reader.asks(({ translate, responsiveTextSize }) => formatTimeSpan(translate, responsiveTextSize, unit, value, interval));
 /**
  * Returns the text for a time span unit.
  */
-export const formatCombinedTimeSpanR = (object) => formatTimeSpanR(object.unit, object.value);
+export const formatCombinedTimeSpanR = (object, interval) => formatTimeSpanR(object.unit, object.value, interval);

package/lib/entities/personalityTrait.js

@@ -23,10 +23,10 @@ export const getPersonalityTraitEntityDescription = createEntityDescriptionCreat
             {
                 type: "definitionList",
                 items: [
-                    ...(translation.effects.map(effect => ({
+                    ...translation.effects.map(effect => ({
                         label: effect.label,
                         value: effect.text,
-                    })) ?? []),
+                    })),
                     entry.combination_options === undefined
                         ? undefined
                         : {
@@ -37,8 +37,7 @@ export const getPersonalityTraitEntityDescription = createEntityDescriptionCreat
                                 .toSorted(on(group => group[0], compareNullish(numAsc)))
                                 .map(([level, options]) => level === null
                                 ? MISSING_VALUE
-                                : `${translate("Level {$level}", { level: romanize(level) })} ${localeJoin(options.map(option => translateMap(option?.translations)?.name ??
-                                    MISSING_VALUE), "disjunction")}`)
+                                : `${translate("Level {$level}", { level: romanize(level) })} ${localeJoin(options.map(option => translateMap(option?.translations)?.name ?? MISSING_VALUE), "disjunction")}`)
                                 .join(", "),
                         },
                     entry.prerequisites === undefined

package/lib/entities/poison.js

@@ -37,7 +37,7 @@ const renderLevel = (translate, translateMap, level) => {
         case "Constant":
             return typeof level.Constant === "number" ? level.Constant : level.Constant.value;
         case "BySubtype":
-            return level.BySubtype.map(subtype => `${subtype.value} (${translateMap(subtype.translations)?.name ?? MISSING_VALUE})`).join(", ");
+            return level.BySubtype.map(subtype => `${subtype.value.toFixed()} (${translateMap(subtype.translations)?.name ?? MISSING_VALUE})`).join(", ");
         default:
             return assertExhaustive(level);
     }
@@ -82,7 +82,7 @@ const renderIntoxicantValues = (translate, translateMap, getInstanceById, intoxi
         overdose: translation?.overdose ?? MISSING_VALUE,
         legality: intoxicant.legality.is_legal ? translate("legal") : translate("illegal"),
         special: translation?.special,
-        addiction: intoxicant?.addiction === undefined
+        addiction: intoxicant.addiction === undefined
             ? undefined
             : renderAddiction(translate, translateMap, getInstanceById, intoxicant.addiction),
     };
@@ -178,7 +178,7 @@ const renderDuration = (translate, translateMap, duration) => {
             return renderMathOperation(duration.ExpressionBased.value, value => {
                 switch (value.kind) {
                     case "Constant":
-                        return value.Constant.toString();
+                        return value.Constant.toFixed();
                     case "Dice":
                         return renderDice(translate, value.Dice);
                     case "CircleOfDamnation":
@@ -247,7 +247,7 @@ export const getPoisonEntityDescription = createEntityDescriptionCreator(({ getI
                     renderAlternativeNames(translate, translation.alternative_names),
                     {
                         label: translate("Level"),
-                        value: level.toString(),
+                        value: typeof level === "number" ? level.toFixed() : level,
                     },
                     {
                         label: translate("Type"),

package/lib/entities/profession.d.ts

@@ -1,4 +1,4 @@
-import { type MagicalActionIdentifier, type RatedIdentifier, type SpecialAbilityIdentifier } from "optolith-database-schema/gen";
+import type { MagicalActionIdentifier, RatedIdentifier, SpecialAbilityIdentifier } from "optolith-database-schema/gen";
 import type { GetAllChildInstancesForParent, GetAllInstances, GetInstanceById } from "../helpers/getTypes.js";
 import { type GetResolvedSelectOptionById } from "./partial/prerequisites/single/activatable.js";
 /**

package/lib/entities/profession.js

@@ -24,6 +24,7 @@ const renderNumericListAcrossPackages = (packages, selector, equalityFn, renderT
     .reduce((accR, pkg, pkgIndex) => accR.map2(selector(pkg), (acc, selected) => selected.reduce((filledAcc, [values, number]) => {
     const existing = filledAcc.findIndex(([value]) => equalityFn(value, values));
     if (existing >= 0) {
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- existing is checked to be >= 0
         filledAcc[existing][1][pkgIndex] = number + defaultValue;
         return filledAcc;
     }
@@ -32,9 +33,7 @@ const renderNumericListAcrossPackages = (packages, selector, equalityFn, renderT
             ...filledAcc,
             [
                 values,
-                Array(pkgIndex)
-                    .fill(defaultValue)
-                    .concat(number + defaultValue),
+                Array.from({ length: pkgIndex }, () => defaultValue).concat(number + defaultValue),
             ],
         ];
     }
@@ -117,12 +116,11 @@ const getTotalingAPValues = (professionPackages, selector) => {
         return undefined;
     }
     return allSame(options, deepEqual)
-        ? options[0].ap_value
+        ? // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- not all are nullish and because all are the same, none is nullish
+            options[0].ap_value
         : options.map(option => option?.ap_value ?? 0).join("/");
 };
-const renderSkillsOption = (professionPackages, skillGroup) => mapNullable(getTotalingAPValues(professionPackages, pkg => pkg.content.options?.skills?.group === skillGroup.id
-    ? pkg.content.options?.skills
-    : undefined), apValue => translateR("{$apValue} AP to improve other {$skillsOfGroup}", {
+const renderSkillsOption = (professionPackages, skillGroup) => mapNullable(getTotalingAPValues(professionPackages, pkg => pkg.content.options?.skills?.group === skillGroup.id ? pkg.content.options.skills : undefined), apValue => translateR("{$apValue} AP to improve other {$skillsOfGroup}", {
     apValue,
     skillsOfGroup: skillGroup.nameOfSkillsOfGroup,
 })) ?? Reader.of(undefined);
@@ -171,6 +169,7 @@ const renderCantripsOption = (professionPackages) => {
         return Reader.of(undefined);
     }
     if (allSame(cantripsOptions, deepEqual)) {
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- not all are nullish and because all are the same, none is nullish
         return renderSingleCantripsOption(cantripsOptions[0]);
     }
     else {
@@ -245,7 +244,7 @@ const renderVariantSkillsOption = (baseOptions, variantOptions) => renderVariant
         apValue: override.ap_value,
         skillsOfGroup: nameOfSkillsOfGroup,
     })),
-    update: (base, override) => plainOrInsteadOfR(base, override, b => b.ap_value, equal, Reader.of).thenW(apValue => plainOrInsteadOfR(base, override, b => b.group, equal, nameOfSkillsOfGroupR).thenW(nameOfSkillsOfGroup => translateR("{$apValue} AP to improve other {$skillsOfGroup}", {
+    update: (base, override) => plainOrInsteadOfR(base, override, b => b.ap_value, equal, b => Reader.of(b)).thenW(apValue => plainOrInsteadOfR(base, override, b => b.group, equal, nameOfSkillsOfGroupR).thenW(nameOfSkillsOfGroup => translateR("{$apValue} AP to improve other {$skillsOfGroup}", {
         apValue,
         skillsOfGroup: nameOfSkillsOfGroup,
     }))),
@@ -389,10 +388,11 @@ const renderBlessings = (professionPackages) => {
         return Reader.of(undefined);
     }
     else if (allSame(traditions, deepEqual)) {
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- not all are empty and because all are the same, none is empty
         return renderSingleBlessings(traditions[0]);
     }
     else {
-        return Reader.traverse(traditions, option => option === undefined ? Reader.of("—") : renderSingleBlessings(option)).map(list => list.join(" / "));
+        return Reader.traverse(traditions, option => option.length === 0 ? Reader.of("—") : renderSingleBlessings(option)).map(list => list.join(" / "));
     }
 };
 const renderLiturgicalChantName = (liturgyIds) => Reader.traverse(liturgyIds, strictNameR).thenW(list => localeJoinR(list, "disjunction"));
@@ -404,7 +404,7 @@ const renderLiturgicalChants = (professionPackages) => Reader.sequence([
 const renderRatedVariantChanges = (baseList, variantList, renderInstance) => Reader.traverse(variantList ?? [], ({ id, rating_modifier }) => {
     const baseValue = baseList?.find(item => deepEqual(item.id, id))?.rating_modifier ?? 0;
     return renderInstance(id).thenW(name => translateR("{$replacement} instead of {$base}", {
-        replacement: `${name} ${baseValue + rating_modifier}`,
+        replacement: `${name} ${(baseValue + rating_modifier).toFixed()}`,
         base: baseValue,
     }));
 }).thenW(localeSortR);
@@ -495,9 +495,14 @@ export const getProfessionVersionEntityDescription = createEntityDescriptionCrea
     }
     return {
         title: translation.name.default +
-            (professionPackages.length > 1
-                ? ` (${professionPackages.map(pkg => translateMap(pkg.experienceLevel.translations)?.name).join("/")})`
-                : ""),
+            parensIf(ensureNonEmpty([
+                translation.specification?.default,
+                professionPackages.length > 1
+                    ? professionPackages
+                        .map(pkg => translateMap(pkg.experienceLevel.translations)?.name)
+                        .join("/")
+                    : undefined,
+            ].filter(isNotNullish))?.join(", ")),
         className: "profession",
         body: [
             {
@@ -529,7 +534,7 @@ export const getProfessionVersionEntityDescription = createEntityDescriptionCrea
                             curses: pkg.content.options?.curses,
                             list: pkg.content.special_abilities,
                         }), deepEqual, specialAbilityLists => Reader.of(specialAbilityLists
-                            .map(specialAbilities => specialAbilities === undefined
+                            .map(specialAbilities => Object.values(specialAbilities).every(list => list === undefined)
                             ? translate("none")
                             : renderSpecialAbilities(specialAbilities).run(env))
                             .join(" / "))).run(env),

package/lib/entities/race.js

@@ -10,11 +10,10 @@ import { renderCommonnessRatedAdvantagesAndDisadvantages, renderCommonnessRatedA
 import { MISSING_VALUE } from "./partial/unknown.js";
 const renderBaseValueItem = (label, value) => Reader.asks(({ translate }) => ({
     label: translate(label),
-    value: value < 0 ? sign(value) : value.toString(),
+    value: value < 0 ? sign(value) : value.toFixed(),
 }));
 const renderAttributeAdjustmentsItem = (totalAttributesCount, adjustments) => Reader.asks(({ translate, translateMap, localeJoin, getInstanceById, }) => {
-    const getAttributeAbbreviation = (id) => translateMap(getInstanceById("Attribute", id)?.translations)
-        ?.abbreviation ?? MISSING_VALUE;
+    const getAttributeAbbreviation = (id) => translateMap(getInstanceById("Attribute", id)?.translations)?.abbreviation ?? MISSING_VALUE;
     return {
         label: translate("Attribute Adjustments"),
         value: [
@@ -35,7 +34,9 @@ const renderVariantValues = (label, variants, selector, renderValue, translation
         };
     });
     const sameValues = anySameIndices(values, on(value => [value.value, value.valueTranslation], deepEqual));
-    if (sameValues.length === 1 && sameValues[0].length === values.length) {
+    if (isNotEmpty(sameValues) &&
+        sameValues.length === 1 &&
+        sameValues[0].length === values.length) {
         return {
             label: translate(label),
             value: values[0] === undefined
@@ -50,9 +51,7 @@ const renderVariantValues = (label, variants, selector, renderValue, translation
                 {
                     type: "definitionList",
                     style: "nested",
-                    items: Map.groupBy(values
-                        .toSorted(on(item => item.name, localeCompare))
-                        .map(value => ({
+                    items: Map.groupBy(values.toSorted(on(item => item.name, localeCompare)).map(value => ({
                         label: value.name,
                         value: value.valueTranslation ?? renderValue(value.value),
                     })), item => item.value)
@@ -72,17 +71,14 @@ const renderAutomaticAdvantagesOrDisadvantages = (entity, items) => Reader.asks(
     : items
         .map(item => {
         const instanceTranslation = translateMap(getInstanceById(entity, item.id)?.translations);
-        return (instanceTranslation?.name_in_library ??
-            instanceTranslation?.name ??
-            MISSING_VALUE);
+        return (instanceTranslation?.name_in_library ?? instanceTranslation?.name ?? MISSING_VALUE);
     })
         .toSorted(localeCompare)
         .join(", "));
 const renderCommonCultures = (items) => Reader.asks(({ translate, translateMap, getInstanceById, localeCompare }) => items === undefined || !isNotEmpty(items)
     ? translate("none")
     : items
-        .map(itemId => translateMap(getInstanceById("Culture", itemId)?.translations)
-        ?.name)
+        .map(itemId => translateMap(getInstanceById("Culture", itemId)?.translations)?.name)
         .filter(isNotNullish)
         .toSorted(localeCompare)
         .join(", "));
@@ -112,7 +108,9 @@ export const getRaceEntityDescription = createEntityDescriptionCreator(({ getIns
                 items: [
                     {
                         label: translate("AP Value"),
-                        value: translate(".input {$value :number} {{{$value} Adventure Points}}", { value: entry.ap_value }),
+                        value: translate(".input {$value :number} {{{$value} Adventure Points}}", {
+                            value: entry.ap_value,
+                        }),
                     },
                     renderBaseValueItem("Life Point Base Value", entry.base_values.life_points).run(env),
                     renderBaseValueItem("Spirit Base Value", entry.base_values.spirit).run(env),

package/lib/entities/sexPractice.js

@@ -22,9 +22,7 @@ export const getSexPracticeEntityDescription = createEntityDescriptionCreator((_
                             label: translate("Prerequisites"),
                             value: translation.prerequisites,
                         },
-                    translation.failed === undefined
-                        ? undefined
-                        : { label: translate("Failed"), value: translation.failed },
+                    { label: translate("Failed"), value: translation.failed },
                 ],
             },
         ],

package/lib/entities/skill.js

@@ -109,10 +109,9 @@ export const getSkillEntityDescription = createEntityDescriptionCreator(({ getIn
                             ? translate("Yes")
                             : entry.encumbrance.kind === "No"
                                 ? translate("No")
-                                : (translation.encumbrance_description ??
-                                    translate("Maybe")),
+                                : (translation.encumbrance_description ?? translate("Maybe")),
                     },
-                    translation?.tools === undefined
+                    translation.tools === undefined
                         ? undefined
                         : {
                             label: translate("Tools"),

package/lib/entities/spell.js

@@ -7,6 +7,7 @@ import { romanize } from "@elyukai/utils/roman";
 import { numAsc } from "@optolith/helpers/compare";
 import { isNotNullish, mapNullable } from "@optolith/helpers/nullable";
 import { assertExhaustive } from "@optolith/helpers/typeSafety";
+import { diffWordsWithSpace } from "diff";
 import { Case } from "tsondb/schema/gen";
 import { createEntityDescriptionCreator } from "../creator.js";
 import { renderAnimalTypesSection } from "./partial/animalTypes.js";
@@ -33,11 +34,20 @@ const combineGeneratedTextWithStaticTranslation = (label, generatedText, staticT
         return undefined;
     }
     const normalizedStaticText = typeof staticText === "string" ? staticText : staticText?.full;
+    const diff = normalizedStaticText === undefined
+        ? undefined
+        : diffWordsWithSpace(normalizedStaticText, generatedText);
     return {
         label,
-        value: normalizedStaticText !== undefined && generatedText !== normalizedStaticText
-            ? `***${generatedText}*** (${normalizedStaticText})`
-            : generatedText,
+        value: diff === undefined
+            ? generatedText
+            : diff
+                .map(part => part.added
+                ? `<ins>${part.value}</ins>`
+                : part.removed
+                    ? `<del>${part.value}</del>`
+                    : part.value)
+                .join(""),
     };
 };
 const renderProperty = (id) => Reader.asks(({ translate, translateMap, getInstanceById }) => {
@@ -854,7 +864,7 @@ const renderMagicalRuneCost = (options, cost) => {
         case "Disjunction":
             return Reader.sequence(cost.Disjunction.list.map(costItem => formatEnergyR(costItem.value).thenW(text => appendNoteIfNeeded(costItem.translations, text)))).thenW(text => localeJoinR(text, "disjunction"));
         case "DerivedFromOption":
-            return deriveValueGroupsFromMagicalRuneOptions(options, option => option.cost?.value, compareNullish(numAsc), num => num?.toString() ?? MISSING_VALUE).thenW(formatEnergyR);
+            return deriveValueGroupsFromMagicalRuneOptions(options, option => option.cost?.value, compareNullish(numAsc), num => num?.toFixed() ?? MISSING_VALUE).thenW(formatEnergyR);
         default:
             return assertExhaustive(cost);
     }

package/lib/helpers/getTypes.d.ts

@@ -1,5 +1,5 @@
-import * as Database from "optolith-database-schema/gen";
-import { IdArgsVariant } from "tsondb/schema/gen";
+import type * as Database from "optolith-database-schema/gen";
+import type { IdArgsVariant } from "tsondb/schema/gen";
 export type GetInstanceById<in T extends Extract<keyof Database.EntityMap, string>> = <U extends T>(...args: IdArgsVariant<Database.EntityMap, U>) => Database.EntityMap[U] | undefined;
 export type GetAllInstances<T extends keyof Database.EntityMap> = <U extends T>(entity: U) => {
     id: string;

package/lib/helpers/locale.d.ts

@@ -1,6 +1,6 @@
-import { Compare } from "@optolith/helpers/compare";
+import type { Compare } from "@optolith/helpers/compare";
 import type { LocaleMeasurementAdjustments } from "optolith-database-schema/gen";
-import { Translate, TranslateMap, type Format } from "./translate.js";
+import type { Format, Translate, TranslateMap } from "./translate.js";
 /**
  * The type of list to join in a locale-aware way.
  */
@@ -12,6 +12,7 @@ export type LocaleEnvironment = {
     id: string;
     format: Format;
     formatDate: (date: Date) => string;
+    formatNumber: FormatNumber;
     translate: Translate;
     translateMap: TranslateMap;
     compare: LocaleCompare;
@@ -26,3 +27,7 @@ export type LocaleCompare = Compare<string>;
  * A function that joins a list of strings according to the locale's rules for the given type.
  */
 export type LocaleJoin = (list: string[], type: LocaleJoinType) => string;
+/**
+ * A function that formats a number according to the locale’s rules.
+ */
+export type FormatNumber = (value: number) => string;

package/lib/helpers/translate.d.ts

@@ -1,4 +1,4 @@
-import { Locale } from "optolith-database-schema/gen";
+import type { Locale } from "optolith-database-schema/gen";
 import { ResponsiveTextSize } from "../entities/partial/responsiveText.js";
 /**
  * The type of all translations

package/lib/index.d.ts

@@ -6,13 +6,14 @@ import type { EntityDescriptionCreator } from "./creator.js";
 import type { GetResolvedSelectOptionById } from "./entities/partial/prerequisites/single/activatable.js";
 import type { CountInstances, GetAllChildInstancesForParent, GetAllInstances, GetInstanceById } from "./helpers/getTypes.js";
 import type { LocaleEnvironment } from "./helpers/locale.js";
-export { LocaleEnvironment };
+export type { LocaleEnvironment };
 /**
  * A JSON representation of the rules text for a library entry.
  */
 export type EntityDescription = {
     title: string;
     subtitle?: string;
+    badge?: number;
     className: string;
     body: EntityDescriptionSection[];
     errata?: {
@@ -44,6 +45,7 @@ export type EntityDescriptionSectionContent<DL = DefinitionListEntityDescription
 export type RawEntityDescription = {
     title: string;
     subtitle?: string;
+    badge?: number;
     className: string;
     body: (RawEntityDescriptionSection | undefined)[];
     errata?: Errata;