@optolith/database-schema 0.58.0 → 0.59.0

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 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.59.0](https://github.com/Optolith/database-schema/compare/v0.58.0...v0.59.0) (2026-09-12)
+
+### ⚠ BREAKING CHANGES
+
+* magical dis-/advantage subtypes
+
+### Features
+
+* magical dis-/advantage subtypes ([986a5a9](https://github.com/Optolith/database-schema/commit/986a5a958f4d2f056ae47bdc6fe3f8627359ced1)), closes [#147](https://github.com/Optolith/database-schema/issues/147)
 ## [0.58.0](https://github.com/Optolith/database-schema/compare/v0.57.0...v0.58.0) (2026-09-11)
 
 ### ⚠ BREAKING CHANGES

package/gen/types.d.ts

@@ -219,6 +219,7 @@ export type EnumMap = {
   AdvancedSpecialAbility: AdvancedSpecialAbility<unknown>
   AdvancedSpecialAbilityRestrictedOptionIdentifier: AdvancedSpecialAbilityRestrictedOptionIdentifier
   AdvantageDisadvantagePrerequisiteGroup: AdvantageDisadvantagePrerequisiteGroup
+  AdvantageDisadvantageSubtype: AdvantageDisadvantageSubtype
   AdventurePointsDependingOnActiveInstances: AdventurePointsDependingOnActiveInstances
   AdventurePointsDependingOnActiveInstancesExpressionValue: AdventurePointsDependingOnActiveInstancesExpressionValue
   AdventurePointsValue: AdventurePointsValue
@@ -2440,6 +2441,10 @@ export interface Locale {
     "only those with at least one blunt side": string
     "only {$nameWithLevel}": string & { __params: { "nameWithLevel": StringableTranslationParameter } }
     "only {$weapons}": string & { __params: { "weapons": StringableTranslationParameter } }
+    "Magical Rank": string
+    "Magical Title": string
+    "Magical Honor": string
+    "Magical Punishment": string
     ".input {$ord :number} {{{$ord}. attack}}": string & { __params: { "ord": number } }
     ".input {$ord :number} {{{$ord}. throw}}": string & { __params: { "ord": number } }
     "depending on the level of the special ability {$name}": string & { __params: { "name": StringableTranslationParameter } }
@@ -3037,6 +3042,8 @@ export interface Advantage {
    */
   levels?: number
 
+  subtype?: AdvantageDisadvantageSubtype
+
   /**
    * Rules for building the name of an activatable. These rules are used when the activatable doesn't have a custom name specified.
    */
@@ -3142,6 +3149,20 @@ export interface AdvantageTranslation {
   errata?: Errata
 }
 
+export type AdvantageDisadvantageSubtype =
+  | {
+    kind: "MagicalRank"
+  }
+  | {
+    kind: "MagicalTitle"
+  }
+  | {
+    kind: "MagicalHonor"
+  }
+  | {
+    kind: "MagicalPunishment"
+  }
+
 export interface GeneralSelectOption {
   /**
    * The entry that contains select option.
@@ -3441,6 +3462,8 @@ export interface Disadvantage {
    */
   levels?: number
 
+  subtype?: AdvantageDisadvantageSubtype
+
   /**
    * Rules for building the name of an activatable. These rules are used when the activatable doesn't have a custom name specified.
    */

package/lib/types/Advantage.d.ts

@@ -1,6 +1,12 @@
 import * as DB from "tsondb/schema/dsl";
 export declare const Advantage: DB.Entity<"Advantage", {
     levels: DB.MemberDecl<DB.Integer, false>;
+    subtype: DB.MemberDecl<DB.IncludeIdentifier<[], DB.Enum<"AdvantageDisadvantageSubtype", {
+        MagicalRank: DB.EnumCase<null>;
+        MagicalTitle: DB.EnumCase<null>;
+        MagicalHonor: DB.EnumCase<null>;
+        MagicalPunishment: DB.EnumCase<null>;
+    }, []>>, false>;
     nameBuilderRules: DB.MemberDecl<DB.IncludeIdentifier<[], DB.TypeAlias<"ActivatableNameBuilderRules", DB.Object<{
         levelPlacement: DB.MemberDecl<DB.IncludeIdentifier<[], DB.Enum<"ActivatableNameLevelPlacement", {
             BeforeOptions: DB.EnumCase<null>;

package/lib/types/Advantage.js

@@ -2,6 +2,7 @@ import * as DB from "tsondb/schema/dsl";
 import { input, levels, maximum, name, name_in_library, range_l10n, rules } from "./_Activatable.js";
 import { ap_value, ap_value_append, ap_value_l10n } from "./_ActivatableAdventurePointsValue.js";
 import { automatic_entries } from "./_ActivatableAutomatic.js";
+import { subtype } from "./_ActivatableMagical.js";
 import { activatableDisplayNameCustomizer, nameBuilderRules } from "./_ActivatableNames.js";
 import { explicit_select_options, select_options } from "./_ActivatableSelectOptions.js";
 import { skill_applications, skill_uses } from "./_ActivatableSkillApplicationsAndUses.js";
@@ -14,6 +15,7 @@ export const Advantage = DB.Entity(import.meta.url, {
     namePlural: "Advantages",
     type: () => DB.Object({
         levels,
+        subtype,
         nameBuilderRules,
         select_options,
         explicit_select_options,

package/lib/types/Disadvantage.d.ts

@@ -1,6 +1,12 @@
 import * as DB from "tsondb/schema/dsl";
 export declare const Disadvantage: DB.Entity<"Disadvantage", {
     levels: DB.MemberDecl<DB.Integer, false>;
+    subtype: DB.MemberDecl<DB.IncludeIdentifier<[], DB.Enum<"AdvantageDisadvantageSubtype", {
+        MagicalRank: DB.EnumCase<null>;
+        MagicalTitle: DB.EnumCase<null>;
+        MagicalHonor: DB.EnumCase<null>;
+        MagicalPunishment: DB.EnumCase<null>;
+    }, []>>, false>;
     nameBuilderRules: DB.MemberDecl<DB.IncludeIdentifier<[], DB.TypeAlias<"ActivatableNameBuilderRules", DB.Object<{
         levelPlacement: DB.MemberDecl<DB.IncludeIdentifier<[], DB.Enum<"ActivatableNameLevelPlacement", {
             BeforeOptions: DB.EnumCase<null>;

package/lib/types/Disadvantage.js

@@ -1,6 +1,7 @@
 import * as DB from "tsondb/schema/dsl";
 import { input, levels, maximum, name, name_in_library, rules } from "./_Activatable.js";
 import { ap_value, ap_value_append, ap_value_l10n } from "./_ActivatableAdventurePointsValue.js";
+import { subtype } from "./_ActivatableMagical.js";
 import { activatableDisplayNameCustomizer, nameBuilderRules } from "./_ActivatableNames.js";
 import { explicit_select_options, select_options } from "./_ActivatableSelectOptions.js";
 import { skill_applications, skill_uses } from "./_ActivatableSkillApplicationsAndUses.js";
@@ -13,6 +14,7 @@ export const Disadvantage = DB.Entity(import.meta.url, {
     namePlural: "Disadvantages",
     type: () => DB.Object({
         levels,
+        subtype,
         nameBuilderRules,
         select_options,
         explicit_select_options,

package/lib/types/Locale.d.ts

@@ -1374,6 +1374,10 @@ export declare const Locale: DB.Entity<"Locale", {
         "only those with at least one blunt side": null;
         "only {$nameWithLevel}": null;
         "only {$weapons}": null;
+        "Magical Rank": null;
+        "Magical Title": null;
+        "Magical Honor": null;
+        "Magical Punishment": null;
         ".input {$ord :number} {{{$ord}. attack}}": null;
         ".input {$ord :number} {{{$ord}. throw}}": null;
         "depending on the level of the special ability {$name}": null;

package/lib/types/Locale.js

@@ -1409,6 +1409,11 @@ export const Locale = DB.Entity(import.meta.url, {
                 "only those with at least one blunt side": null,
                 "only {$nameWithLevel}": null,
                 "only {$weapons}": null,
+                // advantages/disadvantages
+                "Magical Rank": null,
+                "Magical Title": null,
+                "Magical Honor": null,
+                "Magical Punishment": null,
                 // combat special ability -- penalty
                 ".input {$ord :number} {{{$ord}. attack}}": null,
                 ".input {$ord :number} {{{$ord}. throw}}": null,

package/lib/types/_ActivatableMagical.d.ts

@@ -0,0 +1,7 @@
+import * as DB from "tsondb/schema/dsl";
+export declare const subtype: DB.MemberDecl<DB.IncludeIdentifier<[], DB.Enum<"AdvantageDisadvantageSubtype", {
+    MagicalRank: DB.EnumCase<null>;
+    MagicalTitle: DB.EnumCase<null>;
+    MagicalHonor: DB.EnumCase<null>;
+    MagicalPunishment: DB.EnumCase<null>;
+}, []>>, false>;

package/lib/types/_ActivatableMagical.js

@@ -0,0 +1,11 @@
+import * as DB from "tsondb/schema/dsl";
+const AdvantageDisadvantageSubtype = DB.Enum(import.meta.url, {
+    name: "AdvantageDisadvantageSubtype",
+    values: () => ({
+        MagicalRank: DB.EnumCase({ type: null }),
+        MagicalTitle: DB.EnumCase({ type: null }),
+        MagicalHonor: DB.EnumCase({ type: null }),
+        MagicalPunishment: DB.EnumCase({ type: null }),
+    }),
+});
+export const subtype = DB.Optional({ type: DB.IncludeIdentifier(AdvantageDisadvantageSubtype) });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optolith/database-schema",
-  "version": "0.58.0",
+  "version": "0.59.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",