@optolith/entity-descriptions 0.9.2 → 0.11.0

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 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.11.0](https://github.com/Optolith/entity-descriptions/compare/v0.10.0...v0.11.0) (2026-09-13)
+
+### ⚠ BREAKING CHANGES
+
+* **deps:** upgrade to schema 0.61.0
+
+### build
+
+* **deps:** upgrade to schema 0.61.0 ([3883580](https://github.com/Optolith/entity-descriptions/commit/38835809b80d2937d33678bb1643da8f2ab9a200))
+## [0.10.0](https://github.com/Optolith/entity-descriptions/compare/v0.9.2...v0.10.0) (2026-09-12)
+
+### ⚠ BREAKING CHANGES
+
+* **deps:** upgrade to schema 0.59.0
+
+### build
+
+* **deps:** upgrade to schema 0.59.0 ([934588f](https://github.com/Optolith/entity-descriptions/commit/934588f14ca61dc4d78186dc0d7d47cd99c3f847))
 ## [0.9.2](https://github.com/Optolith/entity-descriptions/compare/v0.9.1...v0.9.2) (2026-09-11)
 
 ### Bug Fixes

package/lib/entities/activatable.d.ts

@@ -1,4 +1,4 @@
-import type { ActivatableIdentifier, AdvancedSpecialAbility, AdvantageDisadvantagePrerequisites, AdventurePointsValue, ApplicableCombatTechniques, Aspect_ID, Brew_ID, DaggerRitualCost, EnchantmentCost, Errata, GeneralPrerequisites, MagicalSignCost, Penalty, PropertyDeclaration, PublicationRefs, RatedIdentifier, SelectOptions, SpecialRule, Volume } from "@optolith/database-schema/gen";
+import type { ActivatableIdentifier, AdvancedSpecialAbility, AdvantageDisadvantagePrerequisites, AdvantageDisadvantageSubtype, AdventurePointsValue, ApplicableCombatTechniques, Aspect_ID, Brew_ID, DaggerRitualCost, EnchantmentCost, Errata, GeneralPrerequisites, MagicalSignCost, Penalty, PropertyDeclaration, PublicationRefs, RatedIdentifier, SelectOptions, SpecialRule, Volume } from "@optolith/database-schema/gen";
 import { Case } from "tsondb/schema/gen";
 import type { GetAllInstances, GetInstanceById } from "../helpers/getTypes.js";
 import type { GetAllResolvedNewSkillApplications, GetAllResolvedSelectOptions, GetAllResolvedSkillUses } from "../index.js";
@@ -10,6 +10,7 @@ type AdvancedIdentifierSpecialAbility = string | Case<AdvancedSpecialAbilityKind
  */
 export type BaseActivatable = {
     levels?: number;
+    subtype?: AdvantageDisadvantageSubtype;
     maximum?: number;
     select_options?: SelectOptions;
     usage_type?: Case<"Passive" | "Active" | "BasicManeuver" | "SpecialManeuver">;
@@ -47,8 +48,8 @@ export type BaseActivatableTranslation = {
 /**
  * Get a JSON representation of the rules text for a special ability.
  */
-export declare const getActivatableEntityDescription: import("../creator.js").EntityDescriptionCreator<"Advantage" | "Disadvantage" | "AdvancedCombatSpecialAbility" | "AdvancedKarmaSpecialAbility" | "AdvancedMagicalSpecialAbility" | "AdvancedSkillSpecialAbility" | "AncestorGlyph" | "ArcaneOrbEnchantment" | "AttireEnchantment" | "Beutelzauber" | "BlessedTradition" | "BowlEnchantment" | "BrawlingSpecialAbility" | "CauldronEnchantment" | "CeremonialItemSpecialAbility" | "ChronicleEnchantment" | "CombatSpecialAbility" | "CombatStyleSpecialAbility" | "CommandSpecialAbility" | "DaggerRitual" | "FamiliarSpecialAbility" | "FatePointSexSpecialAbility" | "FatePointSpecialAbility" | "FoolsHatEnchantment" | "GeneralSpecialAbility" | "Haubenzauber" | "Hauerkettenzauber" | "InstrumentEnchantment" | "KarmaSpecialAbility" | "Keulenzauber" | "Krallenkettenzauber" | "Kristallkugelzauber" | "LiturgicalStyleSpecialAbility" | "LycantropicGift" | "MagicalSign" | "MagicalSpecialAbility" | "MagicalTradition" | "MagicStyleSpecialAbility" | "OrbEnchantment" | "PactGift" | "ProtectiveWardingCircleSpecialAbility" | "RingEnchantment" | "Schweinetrommelzauber" | "Sermon" | "SexSpecialAbility" | "SickleRitual" | "SikaryanDrainSpecialAbility" | "SkillStyleSpecialAbility" | "SpellSwordEnchantment" | "StaffEnchantment" | "ToyEnchantment" | "Trinkhornzauber" | "VampiricGift" | "Vision" | "WandEnchantment" | "WeaponEnchantment", {
-    getInstanceById: GetInstanceById<"Publication" | "Subject" | ActivatableIdentifier["kind"] | RatedIdentifier["kind"] | "TradeSecret" | "Aspect" | "Property" | "Race" | "Culture" | "State" | "Enhancement" | "PactCategory" | "PactDomain" | "SocialStatus" | "Weapon" | "Patron" | "PersonalityTrait" | "Blessing" | "Brew">;
+export declare const getActivatableEntityDescription: import("../creator.js").EntityDescriptionCreator<"AdvancedCombatSpecialAbility" | "AdvancedKarmaSpecialAbility" | "AdvancedMagicalSpecialAbility" | "AdvancedSkillSpecialAbility" | "Advantage" | "AncestorGlyph" | "ArcaneOrbEnchantment" | "AttireEnchantment" | "Beutelzauber" | "BlessedTradition" | "BowlEnchantment" | "BrawlingSpecialAbility" | "CauldronEnchantment" | "CeremonialItemSpecialAbility" | "ChronicleEnchantment" | "CombatSpecialAbility" | "CombatStyleSpecialAbility" | "CommandSpecialAbility" | "DaggerRitual" | "Disadvantage" | "FamiliarSpecialAbility" | "FatePointSexSpecialAbility" | "FatePointSpecialAbility" | "FoolsHatEnchantment" | "GeneralSpecialAbility" | "Haubenzauber" | "Hauerkettenzauber" | "InstrumentEnchantment" | "KarmaSpecialAbility" | "Keulenzauber" | "Krallenkettenzauber" | "Kristallkugelzauber" | "LiturgicalStyleSpecialAbility" | "LycantropicGift" | "MagicStyleSpecialAbility" | "MagicalSign" | "MagicalSpecialAbility" | "MagicalTradition" | "OrbEnchantment" | "PactGift" | "ProtectiveWardingCircleSpecialAbility" | "RingEnchantment" | "Schweinetrommelzauber" | "Sermon" | "SexSpecialAbility" | "SickleRitual" | "SikaryanDrainSpecialAbility" | "SkillStyleSpecialAbility" | "SpellSwordEnchantment" | "StaffEnchantment" | "ToyEnchantment" | "Trinkhornzauber" | "VampiricGift" | "Vision" | "WandEnchantment" | "WeaponEnchantment", {
+    getInstanceById: GetInstanceById<"Publication" | "Subject" | ActivatableIdentifier["kind"] | RatedIdentifier["kind"] | "TradeSecret" | "Aspect" | "Property" | "Race" | "Culture" | "State" | "Enhancement" | "PactCategory" | "PactDomain" | "SocialStatus" | "Weapon" | "Patron" | "PersonalityTrait" | "Brew" | "Blessing" | "Cantrip">;
     getAllInstances: GetAllInstances<"Script">;
     getResolvedSelectOptionById: GetResolvedSelectOptionById;
     getAllResolvedSelectOptions: GetAllResolvedSelectOptions;

package/lib/entities/activatable.js

@@ -33,6 +33,34 @@ const isAdvancedSpecialAbilityKind = (value) => value === "AdvancedSkillSpecialA
     value === "AdvancedCombatSpecialAbility" ||
     value === "AdvancedMagicalSpecialAbility" ||
     value === "AdvancedKarmaSpecialAbility";
+const renderAdvantageDisadvantageSubtype = (subtype) => {
+    switch (subtype.kind) {
+        case "MagicalHonor":
+            return translateR("Magical Honor");
+        case "MagicalPunishment":
+            return translateR("Magical Punishment");
+        case "MagicalRank":
+            return translateR("Magical Rank");
+        case "MagicalTitle":
+            return translateR("Magical Title");
+        default:
+            return assertExhaustive(subtype);
+    }
+};
+const renderCombatSpecialAbilityType = (usageType) => {
+    switch (usageType.kind) {
+        case "Active":
+            return translateR("Active");
+        case "Passive":
+            return translateR("Passive");
+        case "BasicManeuver":
+            return translateR("Basic Maneuver");
+        case "SpecialManeuver":
+            return translateR("Special Maneuver");
+        default:
+            return assertExhaustive(usageType);
+    }
+};
 const renderPropertyValue = (getInstanceById, translate, translateMap, propertyDecl) => {
     switch (propertyDecl.kind) {
         case "DependingOnSelection":
@@ -756,20 +784,8 @@ export const getActivatableEntityDescription = createEntityDescriptionCreator(({
     return {
         title: makeTraditionName(translation.name_in_library ?? translation.name) +
             (baseEntry.levels !== undefined ? ` I–${romanize(baseEntry.levels)}` : ""),
-        subtitle: mapNullable(baseEntry.usage_type, usageType => {
-            switch (usageType.kind) {
-                case "Active":
-                    return translate("Active");
-                case "Passive":
-                    return translate("Passive");
-                case "BasicManeuver":
-                    return translate("Basic Maneuver");
-                case "SpecialManeuver":
-                    return translate("Special Maneuver");
-                default:
-                    return assertExhaustive(usageType);
-            }
-        }),
+        subtitle: mapNullable(baseEntry.subtype, subtype => renderAdvantageDisadvantageSubtype(subtype).run(env)) ??
+            mapNullable(baseEntry.usage_type, usageType => renderCombatSpecialAbilityType(usageType).run(env)),
         badge: mapNullable(entityName === "CombatStyleSpecialAbility" || entityName === "AdvancedCombatSpecialAbility"
             ? entry.type
             : undefined, combatType => {

package/lib/entities/disease.d.ts

@@ -3,7 +3,7 @@ import type { IdMap } from "../index.js";
 /**
  * Get a JSON representation of the rules text for an optional rule.
  */
-export declare const getDiseaseEntityDescription: import("../creator.js").EntityDescriptionCreator<"Disease" | "AnimalDisease", {
+export declare const getDiseaseEntityDescription: import("../creator.js").EntityDescriptionCreator<"AnimalDisease" | "Disease", {
     getInstanceById: GetInstanceById<"Publication" | "AnimalType" | "DerivedCharacteristic">;
     idMap: IdMap;
 }, import("../index.js").EntityDescription>;

package/lib/entities/disease.js

@@ -29,6 +29,9 @@ export const getDiseaseEntityDescription = createEntityDescriptionCreator(({ get
             parensIf(ensureNonEmpty([
                 baseEntry.isChildhoodDisease === true ? translate("childhood disease") : undefined,
                 baseEntry.isMagicalDisease === true ? translate("magical disease") : undefined,
+                baseEntry.isSexuallyTransmittableDisease === true
+                    ? translate("sexually transmittable disease")
+                    : undefined,
             ].filter(isNotNullish))?.join(", ")),
         className: "disease",
         body: [

package/lib/entities/elixir.d.ts

@@ -5,6 +5,6 @@ import type { GetResolvedSelectOptionById } from "./partial/prerequisites/single
  * Get a JSON representation of the rules text for an elixir.
  */
 export declare const getElixirEntityDescription: import("../creator.js").EntityDescriptionCreator<"Elixir", {
-    getInstanceById: GetInstanceById<"Publication" | "DerivedCharacteristic" | ActivatableIdentifier["kind"] | RatedIdentifier["kind"] | "Race" | "Culture" | "State" | "Enhancement" | "PactCategory" | "PactDomain" | "SocialStatus" | "Aspect" | "Property" | "PersonalityTrait">;
+    getInstanceById: GetInstanceById<"Publication" | "DerivedCharacteristic" | ActivatableIdentifier["kind"] | RatedIdentifier["kind"] | "Race" | "Culture" | "State" | "Enhancement" | "PactCategory" | "PactDomain" | "SocialStatus" | "Aspect" | "Property" | "PersonalityTrait" | "Blessing" | "Cantrip">;
     getResolvedSelectOptionById: GetResolvedSelectOptionById;
 }, import("../index.js").EntityDescription>;

package/lib/entities/equipment.d.ts

@@ -19,7 +19,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" | "Ammunition" | "Armor" | "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", {
+export declare const getEquipmentEntityDescription: import("../creator.js").EntityDescriptionCreator<"Ammunition" | "Animal" | "AnimalCare" | "Armor" | "BandageOrRemedy" | "Book" | "CeremonialItem" | "Clothes" | "ClothingPackage" | "Container" | "EquipmentOfBlessedOnes" | "GemOrPreciousStone" | "IlluminationLightSource" | "IlluminationRefillOrSupply" | "Jewelry" | "Laboratory" | "Liebesspielzeug" | "LuxuryGood" | "MagicalArtifact" | "MusicalInstrument" | "Newspaper" | "OrienteeringAid" | "RopeOrChain" | "Stationery" | "ThievesTool" | "ToolOfTheTrade" | "TravelGearOrTool" | "Vehicle" | "Weapon" | "WeaponAccessory" | "WorkingSupernaturalCreature", {
     getInstanceById: GetInstanceById<"Publication" | "Attribute" | "Reach" | "SocialStatus" | "CloseCombatTechnique" | "RangedCombatTechnique" | "MagicalTradition" | "BlessedTradition" | "DerivedCharacteristic" | AmmunitionishIdentifier["kind"] | "Race" | "Culture" | "Profession" | "Skill">;
     idMap: IdMap;
 }, import("../index.js").EntityDescription>;

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

@@ -1,7 +1,12 @@
 import type { DisplayOption } from "@optolith/database-schema/gen";
 import type { TranslateMap } from "../../../helpers/translate.js";
+import type { StdReader } from "../reader.js";
 import type { PrerequisitePart } from "./part.js";
 /**
  * Get the translation of a display option.
  */
 export declare const printDisplayOption: (translateMap: TranslateMap, displayOption: DisplayOption) => PrerequisitePart | undefined;
+/**
+ * Get the translation of a display option.
+ */
+export declare const printDisplayOptionR: (displayOption: DisplayOption) => StdReader<PrerequisitePart | undefined, "tm">;

package/lib/entities/partial/prerequisites/displayOption.js

@@ -1,3 +1,4 @@
+import { Reader } from "@elyukai/utils/reader";
 import { assertExhaustive } from "@optolith/helpers/typeSafety";
 import { MISSING_VALUE } from "../unknown.js";
 /**
@@ -17,3 +18,20 @@ export const printDisplayOption = (translateMap, displayOption) => {
             return assertExhaustive(displayOption);
     }
 };
+/**
+ * Get the translation of a display option.
+ */
+export const printDisplayOptionR = (displayOption) => {
+    switch (displayOption.kind) {
+        case "Hide":
+            return Reader.of(undefined);
+        case "ReplaceWith":
+            return Reader.asks(({ translateMap }) => ({
+                value: translateMap(displayOption.ReplaceWith.translations)?.replacement ?? MISSING_VALUE,
+                sentenceType: displayOption.ReplaceWith.sentence_type,
+                isMeta: false,
+            }));
+        default:
+            return assertExhaustive(displayOption);
+    }
+};

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

@@ -13,11 +13,11 @@ export declare const printPublicationPrerequisites: (getInstanceById: GetInstanc
 /**
  * Print plain general prerequisites as a string.
  */
-export declare const printPlainGeneralPrerequisites: (getInstanceById: GetInstanceById<"Race" | "Culture" | "PactCategory" | "PactDomain" | "SocialStatus" | "State" | ActivatableIdentifier["kind"] | RatedIdentifier["kind"] | "Property" | "Aspect" | "Enhancement" | "PersonalityTrait">, getResolvedSelectOptionById: GetResolvedSelectOptionById, locale: LocaleEnvironment, value: PlainGeneralPrerequisites) => string;
+export declare const printPlainGeneralPrerequisites: (getInstanceById: GetInstanceById<"Race" | "Culture" | "PactCategory" | "PactDomain" | "SocialStatus" | "State" | ActivatableIdentifier["kind"] | RatedIdentifier["kind"] | "Property" | "Aspect" | "Enhancement" | "PersonalityTrait" | "Blessing" | "Cantrip">, getResolvedSelectOptionById: GetResolvedSelectOptionById, locale: LocaleEnvironment, value: PlainGeneralPrerequisites) => string;
 /**
  * Print general prerequisites as a string.
  */
-export declare const printGeneralPrerequisites: (getInstanceById: GetInstanceById<"Race" | "Culture" | "PactCategory" | "PactDomain" | "SocialStatus" | "State" | ActivatableIdentifier["kind"] | RatedIdentifier["kind"] | "Property" | "Aspect" | "Enhancement" | "PersonalityTrait">, getResolvedSelectOptionById: GetResolvedSelectOptionById, locale: LocaleEnvironment, value: GeneralPrerequisites, printPreviousLevelPrerequisites?: {
+export declare const printGeneralPrerequisites: (getInstanceById: GetInstanceById<"Race" | "Culture" | "PactCategory" | "PactDomain" | "SocialStatus" | "State" | ActivatableIdentifier["kind"] | RatedIdentifier["kind"] | "Property" | "Aspect" | "Enhancement" | "PersonalityTrait" | "Blessing" | "Cantrip">, getResolvedSelectOptionById: GetResolvedSelectOptionById, locale: LocaleEnvironment, value: GeneralPrerequisites, printPreviousLevelPrerequisites?: {
     id: ActivatableIdentifier;
     levels: number;
 }, trailingText?: string) => string;
@@ -28,7 +28,7 @@ export declare const printProfessionPrerequisites: (getInstanceById: GetInstance
 /**
  * Print advantage disadvantage prerequisites as a string.
  */
-export declare const printAdvantageDisadvantagePrerequisites: (getInstanceById: GetInstanceById<"Race" | "Culture" | "PactCategory" | "PactDomain" | "SocialStatus" | "State" | ActivatableIdentifier["kind"] | RatedIdentifier["kind"] | "Property" | "Aspect" | "Enhancement" | "PersonalityTrait">, getResolvedSelectOptionById: GetResolvedSelectOptionById, locale: LocaleEnvironment, value: AdvantageDisadvantagePrerequisites, name: string, type: "Advantage" | "Disadvantage") => string;
+export declare const printAdvantageDisadvantagePrerequisites: (getInstanceById: GetInstanceById<"Race" | "Culture" | "PactCategory" | "PactDomain" | "SocialStatus" | "State" | ActivatableIdentifier["kind"] | RatedIdentifier["kind"] | "Property" | "Aspect" | "Enhancement" | "PersonalityTrait" | "Blessing" | "Cantrip">, getResolvedSelectOptionById: GetResolvedSelectOptionById, locale: LocaleEnvironment, value: AdvantageDisadvantagePrerequisites, name: string, type: "Advantage" | "Disadvantage") => string;
 /**
  * Print arcane tradition prerequisites as a string.
  */

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

@@ -14,7 +14,7 @@ export declare const printPublicationPrerequisiteGroup: (getInstanceById: GetIns
 /**
  * Print the translation of a general prerequisite group.
  */
-export declare const printGeneralPrerequisiteGroup: (getInstanceById: GetInstanceById<"Race" | "Culture" | "PactCategory" | "PactDomain" | "SocialStatus" | "State" | ActivatableIdentifier["kind"] | RatedIdentifier["kind"] | "Property" | "Aspect" | "Enhancement" | "PersonalityTrait">, getResolvedSelectOptionById: GetResolvedSelectOptionById, locale: LocaleEnvironment, prerequisite: GeneralPrerequisiteGroup) => PrerequisitePart | undefined;
+export declare const printGeneralPrerequisiteGroup: (getInstanceById: GetInstanceById<"Race" | "Culture" | "PactCategory" | "PactDomain" | "SocialStatus" | "State" | ActivatableIdentifier["kind"] | RatedIdentifier["kind"] | "Property" | "Aspect" | "Enhancement" | "PersonalityTrait" | "Blessing" | "Cantrip">, getResolvedSelectOptionById: GetResolvedSelectOptionById, locale: LocaleEnvironment, prerequisite: GeneralPrerequisiteGroup) => PrerequisitePart | undefined;
 /**
  * Print the translation of a profession prerequisite group.
  */
@@ -22,7 +22,7 @@ export declare const printProfessionPrerequisiteGroup: (getInstanceById: GetInst
 /**
  * Print the translation of an advantage/disadvantage prerequisite group.
  */
-export declare const printAdvantageDisadvantagePrerequisiteGroup: (getInstanceById: GetInstanceById<"Race" | "Culture" | "PactCategory" | "PactDomain" | "SocialStatus" | "State" | ActivatableIdentifier["kind"] | RatedIdentifier["kind"] | "Property" | "Aspect" | "Enhancement" | "PersonalityTrait">, getResolvedSelectOptionById: GetResolvedSelectOptionById, locale: LocaleEnvironment, prerequisite: AdvantageDisadvantagePrerequisiteGroup, name: string, type: "Advantage" | "Disadvantage") => PrerequisitePart | undefined;
+export declare const printAdvantageDisadvantagePrerequisiteGroup: (getInstanceById: GetInstanceById<"Race" | "Culture" | "PactCategory" | "PactDomain" | "SocialStatus" | "State" | ActivatableIdentifier["kind"] | RatedIdentifier["kind"] | "Property" | "Aspect" | "Enhancement" | "PersonalityTrait" | "Blessing" | "Cantrip">, getResolvedSelectOptionById: GetResolvedSelectOptionById, locale: LocaleEnvironment, prerequisite: AdvantageDisadvantagePrerequisiteGroup, name: string, type: "Advantage" | "Disadvantage") => PrerequisitePart | undefined;
 /**
  * Print the translation of an arcane tradition prerequisite group.
  */

package/lib/entities/partial/prerequisites/prerequisiteGroups.js

@@ -23,6 +23,7 @@ import { printSexualCharacteristicPrerequisite } from "./single/sexualCharacteri
 import { printSocialStatusPrerequisite } from "./single/socialStatus.js";
 import { printStatePrerequisite } from "./single/state.js";
 import { printTextPrerequisite } from "./single/text.js";
+import { printTinyActivatablePrerequisite } from "./single/tinyActivatable.js";
 /**
  * Print the translation of a derived characteristic prerequisite group.
  */
@@ -75,6 +76,13 @@ export const printGeneralPrerequisiteGroup = (getInstanceById, getResolvedSelect
             return printBlessedTraditionPrerequisite(locale, prerequisite.BlessedTradition);
         case "MagicalTradition":
             return printMagicalTraditionPrerequisite(locale, prerequisite.MagicalTradition);
+        case "TinyActivatable":
+            return printTinyActivatablePrerequisite(prerequisite.TinyActivatable).run({
+                getInstanceById,
+                translateMap: locale.translateMap,
+            });
+        case "AnySpecialAbilityOfGroup":
+            return printMagicalTraditionPrerequisite(locale, prerequisite.AnySpecialAbilityOfGroup);
         case "Rated":
             return printRatedPrerequisite(getInstanceById, locale, prerequisite.Rated);
         case "RatedMinimumNumber":
@@ -135,6 +143,8 @@ export const printAdvantageDisadvantagePrerequisiteGroup = (getInstanceById, get
         case "Activatable":
         case "BlessedTradition":
         case "MagicalTradition":
+        case "AnySpecialAbilityOfGroup":
+        case "TinyActivatable":
         case "Rated":
         case "RatedMinimumNumber":
         case "RatedSum":

package/lib/entities/partial/prerequisites/single/anyActivatableOfGroup.d.ts

@@ -0,0 +1,7 @@
+import type { TinyActivatablePrerequisite } from "@optolith/database-schema/gen";
+import { type StdReader } from "../../reader.js";
+import type { PrerequisitePart } from "../part.js";
+/**
+ * Get the translation of a tiny activatable prerequisite.
+ */
+export declare const printTinyActivatablePrerequisite: (prerequisite: TinyActivatablePrerequisite) => StdReader<PrerequisitePart | undefined, "tm" | "ibi", "Blessing" | "Cantrip">;

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

@@ -0,0 +1,16 @@
+import { attributedCustomNameR } from "../../reader.js";
+import { MISSING_VALUE } from "../../unknown.js";
+import { printDisplayOptionR } from "../displayOption.js";
+/**
+ * Get the translation of a tiny activatable prerequisite.
+ */
+export const printTinyActivatablePrerequisite = (prerequisite) => {
+    if (prerequisite.display_option !== undefined) {
+        return printDisplayOptionR(prerequisite.display_option);
+    }
+    return attributedCustomNameR("prerequisite", (t) => t.abbreviation ?? t.name, prerequisite.id).map(name => ({
+        value: name ?? MISSING_VALUE,
+        sentenceType: undefined,
+        isMeta: false,
+    }));
+};

package/lib/entities/partial/prerequisites/single/anySpecialAbilityOfGroup.d.ts

@@ -0,0 +1,7 @@
+import type { AnySpecialAbilityOfGroupPrerequisite } from "@optolith/database-schema/gen";
+import { type StdReader } from "../../reader.js";
+import type { PrerequisitePart } from "../part.js";
+/**
+ * Get the translation of a tiny activatable prerequisite.
+ */
+export declare const printAnySpecialAbilityOfGroupPrerequisite: (prerequisite: AnySpecialAbilityOfGroupPrerequisite) => StdReader<PrerequisitePart | undefined, "t" | "tm">;

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

@@ -0,0 +1,17 @@
+import { translateR } from "../../reader.js";
+import { printDisplayOptionR } from "../displayOption.js";
+/**
+ * Get the translation of a tiny activatable prerequisite.
+ */
+export const printAnySpecialAbilityOfGroupPrerequisite = (prerequisite) => {
+    if (prerequisite.display_option !== undefined) {
+        return printDisplayOptionR(prerequisite.display_option);
+    }
+    return translateR(".input {$entity :string} {{a special ability}}", {
+        entity: prerequisite.group.kind,
+    }).map(name => ({
+        value: name,
+        sentenceType: undefined,
+        isMeta: false,
+    }));
+};

package/lib/entities/partial/prerequisites/single/rated copy.d.ts

@@ -0,0 +1,8 @@
+import type { RatedPrerequisite } from "@optolith/database-schema/gen";
+import { type GetInstanceById } from "../../../../helpers/getTypes.js";
+import type { LocaleEnvironment } from "../../../../helpers/locale.js";
+import type { PrerequisitePart } from "../part.js";
+/**
+ * Get the translation of a blessed tradition prerequisite.
+ */
+export declare const printRatedPrerequisite: (getInstanceById: GetInstanceById<"Attribute" | "Skill" | "CloseCombatTechnique" | "RangedCombatTechnique" | "Spell" | "Ritual" | "LiturgicalChant" | "Ceremony">, locale: Pick<LocaleEnvironment, "translateMap">, prerequisite: RatedPrerequisite) => PrerequisitePart | undefined;

package/lib/entities/partial/prerequisites/single/rated copy.js

@@ -0,0 +1,17 @@
+import { attributedCustomName } from "../../markdown.js";
+import { MISSING_VALUE } from "../../unknown.js";
+import { printDisplayOption } from "../displayOption.js";
+/**
+ * Get the translation of a blessed tradition prerequisite.
+ */
+export const printRatedPrerequisite = (getInstanceById, locale, prerequisite) => {
+    if (prerequisite.display_option !== undefined) {
+        return printDisplayOption(locale.translateMap, prerequisite.display_option);
+    }
+    const name = attributedCustomName(locale.translateMap, getInstanceById, "prerequisite", (t) => t.abbreviation ?? t.name, prerequisite.id) ?? MISSING_VALUE;
+    return {
+        value: prerequisite.value > 0 ? `${name} ${prerequisite.value.toFixed()}` : name,
+        sentenceType: undefined,
+        isMeta: false,
+    };
+};

package/lib/entities/partial/prerequisites/single/tinyActivatable copy.d.ts

@@ -0,0 +1,7 @@
+import type { TinyActivatablePrerequisite } from "@optolith/database-schema/gen";
+import { type StdReader } from "../../reader.js";
+import type { PrerequisitePart } from "../part.js";
+/**
+ * Get the translation of a tiny activatable prerequisite.
+ */
+export declare const printTinyActivatablePrerequisite: (prerequisite: TinyActivatablePrerequisite) => StdReader<PrerequisitePart | undefined, "tm" | "ibi", "Blessing" | "Cantrip">;

package/lib/entities/partial/prerequisites/single/tinyActivatable copy.js

@@ -0,0 +1,16 @@
+import { attributedCustomNameR } from "../../reader.js";
+import { MISSING_VALUE } from "../../unknown.js";
+import { printDisplayOptionR } from "../displayOption.js";
+/**
+ * Get the translation of a tiny activatable prerequisite.
+ */
+export const printTinyActivatablePrerequisite = (prerequisite) => {
+    if (prerequisite.display_option !== undefined) {
+        return printDisplayOptionR(prerequisite.display_option);
+    }
+    return attributedCustomNameR("prerequisite", (t) => t.abbreviation ?? t.name, prerequisite.id).map(name => ({
+        value: name ?? MISSING_VALUE,
+        sentenceType: undefined,
+        isMeta: false,
+    }));
+};

package/lib/entities/partial/prerequisites/single/tinyActivatable.d.ts

@@ -0,0 +1,7 @@
+import type { TinyActivatablePrerequisite } from "@optolith/database-schema/gen";
+import { type StdReader } from "../../reader.js";
+import type { PrerequisitePart } from "../part.js";
+/**
+ * Get the translation of a tiny activatable prerequisite.
+ */
+export declare const printTinyActivatablePrerequisite: (prerequisite: TinyActivatablePrerequisite) => StdReader<PrerequisitePart | undefined, "tm" | "ibi", "Blessing" | "Cantrip">;

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

@@ -0,0 +1,16 @@
+import { attributedCustomNameR } from "../../reader.js";
+import { MISSING_VALUE } from "../../unknown.js";
+import { printDisplayOptionR } from "../displayOption.js";
+/**
+ * Get the translation of a tiny activatable prerequisite.
+ */
+export const printTinyActivatablePrerequisite = (prerequisite) => {
+    if (prerequisite.display_option !== undefined) {
+        return printDisplayOptionR(prerequisite.display_option);
+    }
+    return attributedCustomNameR("prerequisite", (t) => t.abbreviation ?? t.name, prerequisite.id).map(name => ({
+        value: name ?? MISSING_VALUE,
+        sentenceType: undefined,
+        isMeta: false,
+    }));
+};

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

@@ -42,7 +42,7 @@ export declare const renderIndefiniteCost: (value: IndefiniteCost, shouldAppendN
 /**
  * Returns the text for a standalone one-time cost map of an activatable skill.
  */
-export declare const renderStandaloneCostMap: (value: StandaloneCostMap) => Reader<StdEnv<"tm" | "t" | "rts"> & {
+export declare const renderStandaloneCostMap: (value: StandaloneCostMap) => Reader<StdEnv<"rts" | "t" | "tm"> & {
     translate: import("../../../../helpers/translate.js").Translate;
     energyUnit: import("../../units/energy.js").EnergyUnit;
 }, string>;
@@ -63,7 +63,7 @@ export declare const renderNonModifiableSustainedCost: (value: NonModifiableSust
     responsiveTextSize: import("../../responsiveText.js").ResponsiveTextSize;
 } & {
     translate: import("../../../../helpers/translate.js").Translate;
-} & StdEnv<"f" | "tm" | "t" | "rts"> & StdEnv<"tm" | "t" | "rts" | "eu", never, never, never>, string>;
+} & StdEnv<"f" | "rts" | "t" | "tm"> & StdEnv<"eu" | "rts" | "t" | "tm", never, never, never>, string>;
 /**
  * Returns the text for the cost of a sustained activatable skill.
  */

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

@@ -316,5 +316,5 @@ export declare const modifyBySpeedR: Reader<{
 /**
  * Returns the default values wrapped in a reader if the value is nullish, otherwise applies the given function to the value and returns the result.
  */
-export declare const mapNullableR: <T, U, R>(defaultValue: U, fn: (value: NonNullable<T>) => Reader<U, R>) => (value: T) => Reader<U, R> | Reader<unknown, U>;
+export declare const mapNullableR: <T, U, R>(defaultValue: U, fn: (value: NonNullable<T>) => Reader<U, R>) => (value: T) => Reader<unknown, U> | Reader<U, R>;
 export {};

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

@@ -40,4 +40,4 @@ export declare const replaceTextIfNeeded: (translations: LocaleMap<{
  */
 export declare const appendNoteIfNeeded: (translations: LocaleMap<{
     note?: ResponsiveTextOptional;
-}> | undefined, valueToAppendTo: string) => Reader<StdEnv<"tm" | "rts">, string>;
+}> | undefined, valueToAppendTo: string) => Reader<StdEnv<"rts" | "tm">, string>;

package/lib/entities/poison.d.ts

@@ -6,7 +6,7 @@ import type { GetResolvedSelectOptionById } from "./partial/prerequisites/single
  * Get a JSON representation of the rules text for a poison.
  */
 export declare const getPoisonEntityDescription: import("../creator.js").EntityDescriptionCreator<"Poison", {
-    getInstanceById: GetInstanceById<"Publication" | "DerivedCharacteristic" | "Disease" | ActivatableIdentifier["kind"] | RatedIdentifier["kind"] | "Race" | "Culture" | "State" | "Enhancement" | "PactCategory" | "PactDomain" | "SocialStatus" | "Aspect" | "Property" | "PersonalityTrait">;
+    getInstanceById: GetInstanceById<"Publication" | "DerivedCharacteristic" | "Disease" | ActivatableIdentifier["kind"] | RatedIdentifier["kind"] | "Race" | "Culture" | "State" | "Enhancement" | "PactCategory" | "PactDomain" | "SocialStatus" | "Aspect" | "Property" | "PersonalityTrait" | "Blessing" | "Cantrip">;
     getResolvedSelectOptionById: GetResolvedSelectOptionById;
     idMap: IdMap;
 }, import("../index.js").EntityDescription>;

package/lib/helpers/publicationOptions.d.ts

@@ -0,0 +1,42 @@
+import type { Publication, Publication_ID } from "@optolith/database-schema/gen";
+import type { GetInstanceById } from "./getTypes.js";
+/**
+ * Options for how to render information from different publications in entity descriptions.
+ */
+export type PublicationOptions = {
+    /**
+     * A list of publications to include, identified by their ID. These will always be included no matter the settings in `showPublicationGroups`.
+     */
+    publications: Publication_ID[];
+    /**
+     * Which publication groups to include, no matter if they are explicitly referenced or not.
+     *
+     * - `"none"`: No groups, only explicitly referenced publications
+     * - `"core"`: Core rules
+     * - `"playerOriented"`: Core rules and player-oriented supplements, excluding books with adult content and adventure books.
+     * - `"playerOrientedWithAdult"`: Core rules and player-oriented supplements, excluding adventure books but including books with adult content.
+     * - `"playerOrientedWithAdventures"`: Core rules and player-oriented supplements, including adventure books but excluding books with adult content.
+     * - `"all"`: All groups, including books with adult content and adventure books. Any explicit publication references will have no effect as all publications are included anyway.
+     */
+    showPublicationGroups: "none" | "core" | "playerOriented" | "playerOrientedWithAdult" | "playerOrientedWithAdventures" | "all";
+    /**
+     * How to handle different printings of the same publication.
+     *
+     * - `"none"`: No handling, new and removed entries are treated equally.
+     * - `"latestOnly"`: Only the latest printing of a publication is included, older revisions are ignored.
+     * - `Record<Publication_ID, number>`: A custom handling for each publication, where the number indicates the printing to include.
+     */
+    printingHandling: "none" | "latestOnly" | Record<Publication_ID, number>;
+    /**
+     * If true, only publication references to publications included via `publications` and `showPublicationGroups` will be shown.
+     */
+    onlyShowReferencesToIncludedPublications: boolean;
+};
+/**
+ *
+ */
+export declare const isPublicationIncluded: (publicationOptions: PublicationOptions, publicationId: Publication_ID, publication: Publication) => boolean;
+/**
+ *
+ */
+export declare const isPublicationIncludedById: (getInstanceById: GetInstanceById<"Publication">, publicationOptions: PublicationOptions, publicationId: Publication_ID) => boolean;

package/lib/helpers/publicationOptions.js

@@ -0,0 +1,64 @@
+import { assertExhaustive } from "@elyukai/utils/typeSafety";
+const isPublicationIncludedInGroup = (publication, publicationOptions) => {
+    switch (publicationOptions.showPublicationGroups) {
+        case "none":
+            return false;
+        case "core":
+            switch (publication.category.kind) {
+                case "CoreRules":
+                    return true;
+                case "ExpansionRules":
+                case "Sourcebook":
+                case "RegionalSourcebook":
+                case "Adventure":
+                    return false;
+                default:
+                    return assertExhaustive(publication.category);
+            }
+        case "playerOriented":
+            switch (publication.category.kind) {
+                case "CoreRules":
+                case "ExpansionRules":
+                case "Sourcebook":
+                case "RegionalSourcebook":
+                    return !publication.containsAdultContent;
+                case "Adventure":
+                    return false;
+                default:
+                    return assertExhaustive(publication.category);
+            }
+        case "playerOrientedWithAdult":
+            switch (publication.category.kind) {
+                case "CoreRules":
+                case "ExpansionRules":
+                case "Sourcebook":
+                case "RegionalSourcebook":
+                    return true;
+                case "Adventure":
+                    return false;
+                default:
+                    return assertExhaustive(publication.category);
+            }
+        case "playerOrientedWithAdventures":
+            return !publication.containsAdultContent;
+        case "all":
+            return true;
+        default:
+            return assertExhaustive(publicationOptions.showPublicationGroups);
+    }
+};
+/**
+ *
+ */
+export const isPublicationIncluded = (publicationOptions, publicationId, publication) => publicationOptions.publications.includes(publicationId) ||
+    isPublicationIncludedInGroup(publication, publicationOptions);
+/**
+ *
+ */
+export const isPublicationIncludedById = (getInstanceById, publicationOptions, publicationId) => {
+    const publication = getInstanceById("Publication", publicationId);
+    if (publication === undefined) {
+        return false;
+    }
+    return isPublicationIncluded(publicationOptions, publicationId, publication);
+};