optolith-database-schema 0.27.1 → 0.28.0

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 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.28.0](https://github.com/elyukai/optolith-database-schema/compare/v0.27.1...v0.28.0) (2026-02-01)
+
+
+### ⚠ BREAKING CHANGES
+
+* remodel reversalis
+
+### Features
+
+* remodel reversalis ([99d3bc4](https://github.com/elyukai/optolith-database-schema/commit/99d3bc425cac0693237860d0eedde790e60da0d3))
+
 ## [0.27.1](https://github.com/elyukai/optolith-database-schema/compare/v0.27.0...v0.27.1) (2026-02-01)
 
 

package/gen/types.d.ts

@@ -740,6 +740,8 @@ export type TypeAliasMap = {
   RestrictedToMagicalTraditions: RestrictedToMagicalTraditions
   RestrictedToProfessions: RestrictedToProfessions
   RestrictedToRaces: RestrictedToRaces
+  Reversalis: Reversalis
+  ReversalisEffect: ReversalisEffect
   RulePrerequisite: RulePrerequisite
   RulePrerequisites: RulePrerequisites
   SecondaryArmor: SecondaryArmor
@@ -6968,11 +6970,6 @@ export interface Spell {
    */
   property: Property_ID
 
-  /**
-   * The associated property of the reversed spell.
-   */
-  propertyReversalis?: Property_ID
-
   /**
    * The tradition(s) the spell is available for. It may be *generally* available to all traditions or it may be only familiar in specific traditions.
    */
@@ -6988,6 +6985,11 @@ export interface Spell {
    */
   prerequisites?: SpellworkPrerequisites
 
+  /**
+   * Possible effects of the reversed spell.
+   */
+  reversalis?: Reversalis
+
   /**
    * References to where in which publications this entry has been defined. Entries may also be added or removed in later printings.
    */
@@ -7019,11 +7021,6 @@ export interface SpellTranslation {
    */
   effect: ActivatableSkillEffect
 
-  /**
-   * The effect of the reversed spell.
-   */
-  effectReversalis?: string
-
   casting_time?: OldParameter
 
   cost?: OldParameter
@@ -7419,11 +7416,6 @@ export interface Ritual {
    */
   property: Property_ID
 
-  /**
-   * The associated property of the reversed spell.
-   */
-  propertyReversalis?: Property_ID
-
   /**
    * The tradition(s) the ritual is available for. It may be *generally* available to all traditions or it may be only familiar in specific traditions.
    */
@@ -7439,6 +7431,11 @@ export interface Ritual {
    */
   prerequisites?: SpellworkPrerequisites
 
+  /**
+   * Possible effects of the reversed spell.
+   */
+  reversalis?: Reversalis
+
   /**
    * References to where in which publications this entry has been defined. Entries may also be added or removed in later printings.
    */
@@ -7470,11 +7467,6 @@ export interface RitualTranslation {
    */
   effect: ActivatableSkillEffect
 
-  /**
-   * The effect of the reversed spell.
-   */
-  effectReversalis?: string
-
   casting_time?: OldParameter
 
   cost?: OldParameter
@@ -7516,6 +7508,35 @@ export interface SlowSkillNonModifiableCastingTime {
 
 export type SlowSustainedPerformanceParameters = SustainedPerformanceParameters<SlowCastingTime>
 
+/**
+ * Possible effects of the reversed spell.
+ */
+export type Reversalis = ReversalisEffect[]
+
+/**
+ * A single possible effect of the reversed spell. A reversed spell can have a different property than the original spell.
+ */
+export interface ReversalisEffect {
+  /**
+   * The associated property of the reversed spell.
+   */
+  property: Property_ID
+
+  /**
+   * All translations for the entry, identified by IETF language tag (BCP47).
+   */
+  translations: {
+    [localeId: string]: ReversalisEffectTranslation
+  }
+}
+
+export interface ReversalisEffectTranslation {
+  /**
+   * The effect description of the reversed spell.
+   */
+  effect: string
+}
+
 export interface Ceremony {
   /**
    * Lists the linked three attributes used to make a skill check.

package/lib/types/Ritual.d.ts

@@ -475,7 +475,6 @@ export declare const Ritual: Entity<"Ritual", {
         }>, false>;
     }>, []>>>, []>>, true>;
     property: import("tsondb/schema/def").MemberDecl<import("tsondb/schema/def").ReferenceIdentifierType, true>;
-    propertyReversalis: import("tsondb/schema/def").MemberDecl<import("tsondb/schema/def").ReferenceIdentifierType, false>;
     traditions: import("tsondb/schema/def").MemberDecl<IncludeIdentifier<[], import("tsondb/schema/def").EnumDecl<"SpellworkTraditions", {
         General: import("tsondb/schema/def").EnumCaseDecl<null>;
         Specific: import("tsondb/schema/def").EnumCaseDecl<import("tsondb/schema/def").ArrayType<import("tsondb/schema/def").ReferenceIdentifierType>>;
@@ -510,6 +509,12 @@ export declare const Ritual: Entity<"Ritual", {
             }>, true>;
         }>, [T: import("tsondb/schema/def").TypeParameter<"T", import("tsondb/schema/def").Type>]>>>;
     }, [T: import("tsondb/schema/def").TypeParameter<"T", import("tsondb/schema/def").Type>]>>>, [T: import("tsondb/schema/def").TypeParameter<"T", import("tsondb/schema/def").Type>]>>, []>>, false>;
+    reversalis: import("tsondb/schema/def").MemberDecl<IncludeIdentifier<[], import("tsondb/schema/def").TypeAliasDecl<"Reversalis", import("tsondb/schema/def").ArrayType<IncludeIdentifier<[], import("tsondb/schema/def").TypeAliasDecl<"ReversalisEffect", Object<{
+        property: import("tsondb/schema/def").MemberDecl<import("tsondb/schema/def").ReferenceIdentifierType, true>;
+        translations: import("tsondb/schema/def").MemberDecl<import("tsondb/schema/def").NestedEntityMapType<"ReversalisEffectTranslation", {
+            effect: import("tsondb/schema/def").MemberDecl<String, true>;
+        }>, true>;
+    }>, []>>>, []>>, false>;
     src: import("tsondb/schema/def").MemberDecl<IncludeIdentifier<[], import("tsondb/schema/def").TypeAliasDecl<"PublicationRefs", import("tsondb/schema/def").ArrayType<IncludeIdentifier<[], import("tsondb/schema/def").TypeAliasDecl<"PublicationRef", Object<{
         id: import("tsondb/schema/def").MemberDecl<import("tsondb/schema/def").ReferenceIdentifierType, true>;
         occurrences: import("tsondb/schema/def").MemberDecl<import("tsondb/schema/def").NestedEntityMapType<string, {
@@ -567,7 +572,6 @@ export declare const Ritual: Entity<"Ritual", {
                 text_after: import("tsondb/schema/def").MemberDecl<String, false>;
             }>, []>>>;
         }, []>>, true>;
-        effectReversalis: import("tsondb/schema/def").MemberDecl<String, false>;
         casting_time: import("tsondb/schema/def").MemberDecl<IncludeIdentifier<[], import("tsondb/schema/def").TypeAliasDecl<"OldParameter", Object<{
             full: import("tsondb/schema/def").MemberDecl<String, true>;
             abbr: import("tsondb/schema/def").MemberDecl<String, true>;

package/lib/types/Ritual.js

@@ -7,7 +7,7 @@ import { PropertyIdentifier } from "./_Identifier.js";
 import { ImprovementCost } from "./_ImprovementCost.js";
 import { SpellworkPrerequisites } from "./_Prerequisite.js";
 import { SkillCheck, SkillCheckPenalty } from "./_SkillCheck.js";
-import { checkReversalis, ReversalisEffect, ReversalisProperty, SpellworkTraditions, } from "./_Spellwork.js";
+import { reversalis, SpellworkTraditions } from "./_Spellwork.js";
 import { NestedTranslationMap } from "./Locale.js";
 import { Errata } from "./source/_Erratum.js";
 import { src } from "./source/_PublicationRef.js";
@@ -35,7 +35,6 @@ export const Ritual = Entity(import.meta.url, {
             comment: "The associated property.",
             type: PropertyIdentifier(),
         }),
-        propertyReversalis: ReversalisProperty(),
         traditions: Required({
             comment: "The tradition(s) the ritual is available for. It may be *generally* available to all traditions or it may be only familiar in specific traditions.",
             type: IncludeIdentifier(SpellworkTraditions),
@@ -48,6 +47,7 @@ export const Ritual = Entity(import.meta.url, {
             comment: "The prerequisites for the ritual.",
             type: IncludeIdentifier(SpellworkPrerequisites),
         }),
+        reversalis,
         src,
         translations: NestedTranslationMap(Required, "Ritual", Object({
             name: Required({
@@ -58,7 +58,6 @@ export const Ritual = Entity(import.meta.url, {
                 comment: "The effect description may be either a plain text or a text that is divided by a list of effects for each quality level. It may also be a list for each two quality levels.",
                 type: IncludeIdentifier(ActivatableSkillEffect),
             }),
-            effectReversalis: ReversalisEffect(),
             casting_time: Optional({
                 isDeprecated: true,
                 type: IncludeIdentifier(OldParameter),
@@ -94,5 +93,4 @@ export const Ritual = Entity(import.meta.url, {
             keyPathInEntityMap: "name",
         },
     ],
-    customConstraints: ({ instanceContent }) => checkReversalis(instanceContent),
 });

package/lib/types/Spell.d.ts

@@ -475,7 +475,6 @@ export declare const Spell: Entity<"Spell", {
         }>, false>;
     }>, []>>>, []>>, true>;
     property: import("tsondb/schema/def").MemberDecl<import("tsondb/schema/def").ReferenceIdentifierType, true>;
-    propertyReversalis: import("tsondb/schema/def").MemberDecl<import("tsondb/schema/def").ReferenceIdentifierType, false>;
     traditions: import("tsondb/schema/def").MemberDecl<IncludeIdentifier<[], import("tsondb/schema/def").EnumDecl<"SpellworkTraditions", {
         General: import("tsondb/schema/def").EnumCaseDecl<null>;
         Specific: import("tsondb/schema/def").EnumCaseDecl<import("tsondb/schema/def").ArrayType<import("tsondb/schema/def").ReferenceIdentifierType>>;
@@ -510,6 +509,12 @@ export declare const Spell: Entity<"Spell", {
             }>, true>;
         }>, [T: import("tsondb/schema/def").TypeParameter<"T", import("tsondb/schema/def").Type>]>>>;
     }, [T: import("tsondb/schema/def").TypeParameter<"T", import("tsondb/schema/def").Type>]>>>, [T: import("tsondb/schema/def").TypeParameter<"T", import("tsondb/schema/def").Type>]>>, []>>, false>;
+    reversalis: import("tsondb/schema/def").MemberDecl<IncludeIdentifier<[], import("tsondb/schema/def").TypeAliasDecl<"Reversalis", import("tsondb/schema/def").ArrayType<IncludeIdentifier<[], import("tsondb/schema/def").TypeAliasDecl<"ReversalisEffect", Object<{
+        property: import("tsondb/schema/def").MemberDecl<import("tsondb/schema/def").ReferenceIdentifierType, true>;
+        translations: import("tsondb/schema/def").MemberDecl<import("tsondb/schema/def").NestedEntityMapType<"ReversalisEffectTranslation", {
+            effect: import("tsondb/schema/def").MemberDecl<String, true>;
+        }>, true>;
+    }>, []>>>, []>>, false>;
     src: import("tsondb/schema/def").MemberDecl<IncludeIdentifier<[], import("tsondb/schema/def").TypeAliasDecl<"PublicationRefs", import("tsondb/schema/def").ArrayType<IncludeIdentifier<[], import("tsondb/schema/def").TypeAliasDecl<"PublicationRef", Object<{
         id: import("tsondb/schema/def").MemberDecl<import("tsondb/schema/def").ReferenceIdentifierType, true>;
         occurrences: import("tsondb/schema/def").MemberDecl<import("tsondb/schema/def").NestedEntityMapType<string, {
@@ -567,7 +572,6 @@ export declare const Spell: Entity<"Spell", {
                 text_after: import("tsondb/schema/def").MemberDecl<String, false>;
             }>, []>>>;
         }, []>>, true>;
-        effectReversalis: import("tsondb/schema/def").MemberDecl<String, false>;
         casting_time: import("tsondb/schema/def").MemberDecl<IncludeIdentifier<[], import("tsondb/schema/def").TypeAliasDecl<"OldParameter", Object<{
             full: import("tsondb/schema/def").MemberDecl<String, true>;
             abbr: import("tsondb/schema/def").MemberDecl<String, true>;

package/lib/types/Spell.js

@@ -7,7 +7,7 @@ import { PropertyIdentifier } from "./_Identifier.js";
 import { ImprovementCost } from "./_ImprovementCost.js";
 import { SpellworkPrerequisites } from "./_Prerequisite.js";
 import { SkillCheck, SkillCheckPenalty } from "./_SkillCheck.js";
-import { checkReversalis, ReversalisEffect, ReversalisProperty, SpellworkTraditions, } from "./_Spellwork.js";
+import { reversalis, SpellworkTraditions } from "./_Spellwork.js";
 import { NestedTranslationMap } from "./Locale.js";
 import { Errata } from "./source/_Erratum.js";
 import { src } from "./source/_PublicationRef.js";
@@ -35,7 +35,6 @@ export const Spell = Entity(import.meta.url, {
             comment: "The associated property.",
             type: PropertyIdentifier(),
         }),
-        propertyReversalis: ReversalisProperty(),
         traditions: Required({
             comment: "The tradition(s) the spell is available for. It may be *generally* available to all traditions or it may be only familiar in specific traditions.",
             type: IncludeIdentifier(SpellworkTraditions),
@@ -48,6 +47,7 @@ export const Spell = Entity(import.meta.url, {
             comment: "The prerequisites for the spell.",
             type: IncludeIdentifier(SpellworkPrerequisites),
         }),
+        reversalis,
         src,
         translations: NestedTranslationMap(Required, "Spell", Object({
             name: Required({
@@ -58,7 +58,6 @@ export const Spell = Entity(import.meta.url, {
                 comment: "The effect description may be either a plain text or a text that is divided by a list of effects for each quality level. It may also be a list for each two quality levels.",
                 type: IncludeIdentifier(ActivatableSkillEffect),
             }),
-            effectReversalis: ReversalisEffect(),
             casting_time: Optional({
                 isDeprecated: true,
                 type: IncludeIdentifier(OldParameter),
@@ -94,5 +93,4 @@ export const Spell = Entity(import.meta.url, {
             keyPathInEntityMap: "name",
         },
     ],
-    customConstraints: ({ instanceContent }) => checkReversalis(instanceContent),
 });

package/lib/types/_Spellwork.d.ts

@@ -1,15 +1,17 @@
-import { Array, Enum, EnumCase, String } from "tsondb/schema/def";
+import { Array, Enum, EnumCase, IncludeIdentifier, Object, String, TypeAlias } from "tsondb/schema/def";
 export declare const SpellworkTraditions: Enum<"SpellworkTraditions", {
     General: EnumCase<null>;
     Specific: EnumCase<Array<import("tsondb/schema/def").ReferenceIdentifierType>>;
 }, []>;
-export declare const ReversalisProperty: () => import("tsondb/schema/def").MemberDecl<import("tsondb/schema/def").ReferenceIdentifierType, false>;
-export declare const ReversalisEffect: () => import("tsondb/schema/def").MemberDecl<String, false>;
-export declare const checkReversalis: (object: {
-    propertyReversalis?: string;
-    translations: {
-        [locale: string]: {
-            effectReversalis?: string;
-        };
-    };
-}) => string[];
+export declare const Reversalis: TypeAlias<"Reversalis", Array<IncludeIdentifier<[], TypeAlias<"ReversalisEffect", Object<{
+    property: import("tsondb/schema/def").MemberDecl<import("tsondb/schema/def").ReferenceIdentifierType, true>;
+    translations: import("tsondb/schema/def").MemberDecl<import("tsondb/schema/def").NestedEntityMapType<"ReversalisEffectTranslation", {
+        effect: import("tsondb/schema/def").MemberDecl<String, true>;
+    }>, true>;
+}>, []>>>, []>;
+export declare const reversalis: import("tsondb/schema/def").MemberDecl<IncludeIdentifier<[], TypeAlias<"Reversalis", Array<IncludeIdentifier<[], TypeAlias<"ReversalisEffect", Object<{
+    property: import("tsondb/schema/def").MemberDecl<import("tsondb/schema/def").ReferenceIdentifierType, true>;
+    translations: import("tsondb/schema/def").MemberDecl<import("tsondb/schema/def").NestedEntityMapType<"ReversalisEffectTranslation", {
+        effect: import("tsondb/schema/def").MemberDecl<String, true>;
+    }>, true>;
+}>, []>>>, []>>, false>;

package/lib/types/_Spellwork.js

@@ -1,5 +1,6 @@
-import { Array, Enum, EnumCase, Optional, String } from "tsondb/schema/def";
+import { Array, Enum, EnumCase, IncludeIdentifier, Object, Optional, Required, String, TypeAlias, } from "tsondb/schema/def";
 import { MagicalTraditionIdentifier, PropertyIdentifier } from "./_Identifier.js";
+import { NestedTranslationMap } from "./Locale.js";
 export const SpellworkTraditions = Enum(import.meta.url, {
     name: "SpellworkTraditions",
     comment: "The tradition(s) the spell or ritual is available for. It may be *generally* available to all traditions or it may be only familiar in specific traditions.",
@@ -11,24 +12,28 @@ export const SpellworkTraditions = Enum(import.meta.url, {
         }),
     }),
 });
-export const ReversalisProperty = () => Optional({
-    comment: "The associated property of the reversed spell.",
-    type: PropertyIdentifier(),
+export const Reversalis = TypeAlias(import.meta.url, {
+    name: "Reversalis",
+    comment: "Possible effects of the reversed spell.",
+    type: () => Array(IncludeIdentifier(ReversalisEffect), { minItems: 1 }),
 });
-export const ReversalisEffect = () => Optional({
-    comment: "The effect of the reversed spell.",
-    type: String({ minLength: 1, isMarkdown: true }),
+export const reversalis = Optional({
+    comment: "Possible effects of the reversed spell.",
+    type: IncludeIdentifier(Reversalis),
+});
+const ReversalisEffect = TypeAlias(import.meta.url, {
+    name: "ReversalisEffect",
+    comment: "A single possible effect of the reversed spell. A reversed spell can have a different property than the original spell.",
+    type: () => Object({
+        property: Required({
+            comment: "The associated property of the reversed spell.",
+            type: PropertyIdentifier(),
+        }),
+        translations: NestedTranslationMap(Required, "ReversalisEffect", Object({
+            effect: Required({
+                comment: "The effect description of the reversed spell.",
+                type: String({ minLength: 1, isMarkdown: true }),
+            }),
+        })),
+    }),
 });
-export const checkReversalis = (object) => {
-    const hasProperty = object.propertyReversalis !== undefined;
-    const hasAnyEffect = Object.values(object.translations).some(t => t.effectReversalis !== undefined);
-    if (hasProperty && !hasAnyEffect) {
-        return [
-            "If 'propertyReversalis' is set, at least one translation must have 'effectReversalis' defined.",
-        ];
-    }
-    if (!hasProperty && hasAnyEffect) {
-        return ["If any translation has 'effectReversalis' defined, 'propertyReversalis' must be set."];
-    }
-    return [];
-};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "optolith-database-schema",
-  "version": "0.27.1",
+  "version": "0.28.0",
   "description": "Definitions and utilities for the flat-file database of Optolith, a character creation tool for the Pen and Paper RPG “The Dark Eye 5”, and its external integrations into other software.",
   "keywords": [
     "tde",