@optolith/database-schema 0.78.0 → 0.79.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.79.0](https://github.com/Optolith/database-schema/compare/v0.78.0...v0.79.0) (2026-10-05)
+
+### ⚠ BREAKING CHANGES
+
+* burning time option for generic items
+
+### Features
+
+* base for select option rules ([5df53d3](https://github.com/Optolith/database-schema/commit/5df53d3448d5c279c9a062b8c68cc4e5ee9cbfdb))
+* burning time option for generic items ([7feb7ff](https://github.com/Optolith/database-schema/commit/7feb7ffb449724433c7f7012369c837d5b8f6688))
+
 ## [0.78.0](https://github.com/Optolith/database-schema/compare/v0.77.1...v0.78.0) (2026-10-05)
 
 ### ⚠ BREAKING CHANGES

package/gen/types.d.ts

@@ -277,6 +277,7 @@ export type EnumMap = {
   CastingTime: CastingTime<unknown>
   CastingTimeDuringLovemakingUnit: CastingTimeDuringLovemakingUnit
   CheckResultArithmetic: CheckResultArithmetic
+  ChildEntityForSelectOption: ChildEntityForSelectOption
   CollectorsValue: CollectorsValue
   CombatAnimalPowerType: CombatAnimalPowerType
   CombatRelatedSpecialAbilityIdentifier: CombatRelatedSpecialAbilityIdentifier
@@ -438,6 +439,8 @@ export type EnumMap = {
   RulePrerequisiteGroup: RulePrerequisiteGroup
   SelectOptionCategory: SelectOptionCategory
   SelectOptionParentIdentifier: SelectOptionParentIdentifier
+  SelectOptionRuleMultiple: SelectOptionRuleMultiple
+  SelectOptionRuleValue: SelectOptionRuleValue
   SelectOptionsAdventurePointsValue: SelectOptionsAdventurePointsValue<unknown>
   SelectOptionsBindingCostValue: SelectOptionsBindingCostValue<unknown>
   SentenceType: SentenceType
@@ -571,6 +574,7 @@ export type TypeAliasMap = {
   Cause: Cause
   CheckResultBasedModifier: CheckResultBasedModifier
   ChildNode: ChildNode
+  ChildSelectOptionRuleValue: ChildSelectOptionRuleValue
   ChurchBlessedTradition: ChurchBlessedTradition
   CloseCombatTechniqueSpecialRules: CloseCombatTechniqueSpecialRules
   CombatAnimalPower: CombatAnimalPower
@@ -827,6 +831,7 @@ export type TypeAliasMap = {
   PlantPoison: PlantPoison
   PoisonRecipe: PoisonRecipe
   Preconditions: Preconditions
+  PredefinedOrTextInputSelectOptionRuleValue: PredefinedOrTextInputSelectOptionRuleValue
   PrerequisiteForLevel: PrerequisiteForLevel<unknown>
   PrerequisiteGroup: PrerequisiteGroup<unknown>
   PrerequisitesDisjunction: PrerequisitesDisjunction<unknown>
@@ -894,6 +899,8 @@ export type TypeAliasMap = {
   RulePrerequisites: RulePrerequisites
   SecondaryArmor: SecondaryArmor
   SelectableAttributeAdjustment: SelectableAttributeAdjustment
+  SelectOptionRule: SelectOptionRule
+  SelectOptionRules: SelectOptionRules
   SelectOptions: SelectOptions
   SelectOptionsDeriveAdventurePointsValueFromImprovementCost: SelectOptionsDeriveAdventurePointsValueFromImprovementCost
   SelectOptionsFixedAdventurePointsValue: SelectOptionsFixedAdventurePointsValue<unknown>
@@ -960,6 +967,7 @@ export type TypeAliasMap = {
   TalismanMeleeWeapon: TalismanMeleeWeapon
   TalismanRangedWeapon: TalismanRangedWeapon
   TargetCategoriesSelectOptionCategory: TargetCategoriesSelectOptionCategory
+  TextInputSelectOptionRuleValue: TextInputSelectOptionRuleValue
   TextNode: TextNode
   TextPrerequisite: TextPrerequisite
   TinyActivatablePrerequisite: TinyActivatablePrerequisite
@@ -1155,6 +1163,11 @@ export interface SelectOptions {
    * An entry category with optional further configuration. All available entries from the specified categories will be included as separate select options. You can also specify a set of groups that should only be included. Groups not mentioned will be excluded then.
    */
   derived?: SelectOptionCategory
+
+  /**
+   * Rules for how options can be selected and relate to each other. Defaults to a single predefined option if the entry has select options defined, otherwise undefined.
+   */
+  rules?: SelectOptionRules
 }
 
 export type SelectOptionCategory =
@@ -15083,6 +15096,13 @@ export interface Hauerkettenzauber {
    */
   nameBuilderRules?: ActivatableNameBuilderRules
 
+  /**
+   * Definitions for possible options for the activatable entry, derived from entry categories.
+   * 
+   * Note that this is only a full definition of options for simple logic that can be made explicit using the more detailed configuration for both derived categories and explicit options. There are quite a few entries whose option logic cannot be fully represented here, so that it needs to be implemented manually.
+   */
+  select_options?: SelectOptions
+
   /**
    * The number stating how often you can buy the entry. The **default** depends on the entry type:
    * 
@@ -15407,6 +15427,13 @@ export interface Keulenzauber {
    */
   nameBuilderRules?: ActivatableNameBuilderRules
 
+  /**
+   * Definitions for possible options for the activatable entry, derived from entry categories.
+   * 
+   * Note that this is only a full definition of options for simple logic that can be made explicit using the more detailed configuration for both derived categories and explicit options. There are quite a few entries whose option logic cannot be fully represented here, so that it needs to be implemented manually.
+   */
+  select_options?: SelectOptions
+
   /**
    * The number stating how often you can buy the entry. The **default** depends on the entry type:
    * 
@@ -16821,6 +16848,13 @@ export interface Schweinetrommelzauber {
    */
   nameBuilderRules?: ActivatableNameBuilderRules
 
+  /**
+   * Definitions for possible options for the activatable entry, derived from entry categories.
+   * 
+   * Note that this is only a full definition of options for simple logic that can be made explicit using the more detailed configuration for both derived categories and explicit options. There are quite a few entries whose option logic cannot be fully represented here, so that it needs to be implemented manually.
+   */
+  select_options?: SelectOptions
+
   /**
    * The number stating how often you can buy the entry. The **default** depends on the entry type:
    * 
@@ -22466,6 +22500,123 @@ export type AdvantageDisadvantagePrerequisiteGroup =
     PersonalityTrait: PersonalityTraitPrerequisite
   }
 
+/**
+ * Rules for how options can be selected and relate to each other. Defaults to a single predefined option if the entry has select options defined, otherwise undefined.
+ */
+export type SelectOptionRules = SelectOptionRule[]
+
+/**
+ * A rule for how options can be selected and relate to each other.
+ */
+export interface SelectOptionRule {
+  /**
+   * The value of the rule.
+   */
+  value: SelectOptionRuleValue
+
+  /**
+   * Sometimes, multiple options from a single list have to or can be chosen.
+   */
+  multiple?: SelectOptionRuleMultiple
+}
+
+/**
+ * The possible values for select option rules.
+ */
+export type SelectOptionRuleValue =
+  | {
+    kind: "Predefined"
+  }
+  | {
+    kind: "PredefinedOrTextInput"
+    PredefinedOrTextInput: PredefinedOrTextInputSelectOptionRuleValue
+  }
+  | {
+    kind: "Child"
+    Child: ChildSelectOptionRuleValue
+  }
+  | {
+    kind: "TextInput"
+    TextInput: TextInputSelectOptionRuleValue
+  }
+
+export interface PredefinedOrTextInputSelectOptionRuleValue {
+  /**
+   * All translations for the entry, identified by IETF language tag (BCP47).
+   */
+  translations: {
+    [localeId: string]: PredefinedOrTextInputSelectOptionRuleValueTranslation
+  }
+}
+
+export interface PredefinedOrTextInputSelectOptionRuleValueTranslation {
+  /**
+   * The label for the text input field.
+   */
+  inputLabel: string
+
+  /**
+   * The label for the extra option in the list of select options that unlocks the text input field.
+   */
+  optionLabel: string
+}
+
+export interface ChildSelectOptionRuleValue {
+  /**
+   * The index of the parent select option in the list of selected options.
+   */
+  parentIndex: number
+
+  /**
+   * The entity you can choose from.
+   */
+  entity: ChildEntityForSelectOption
+}
+
+/**
+ * The possible child entities for select options.
+ */
+export type ChildEntityForSelectOption =
+  | {
+    kind: "SkillApplication"
+  }
+
+export interface TextInputSelectOptionRuleValue {
+  /**
+   * All translations for the entry, identified by IETF language tag (BCP47).
+   */
+  translations: {
+    [localeId: string]: TextInputSelectOptionRuleValueTranslation
+  }
+}
+
+export interface TextInputSelectOptionRuleValueTranslation {
+  /**
+   * The label for the text input field.
+   */
+  inputLabel: string
+}
+
+export type SelectOptionRuleMultiple =
+  | {
+    kind: "Constant"
+    Constant: number
+  }
+  | {
+    kind: "Range"
+    Range: {
+      /**
+       * The minimum number of options that need to be selected. If left empty it defaults to 1.
+       */
+      min?: number
+
+      /**
+       * The maximum number of options that need to be selected.
+       */
+      max: number
+    }
+  }
+
 export interface AlternativeRule {
   /**
    * The player types this alternative rule is suitable for.
@@ -24354,6 +24505,11 @@ export interface DefaultEquipmentCategoryTypeRules {
    * Presence of complexity to certain groups for items in this category.
    */
   complexity: ValueRule
+
+  /**
+   * Presence of burning time to certain groups for items in this category.
+   */
+  burningTime: ValueRule
 }
 
 /**
@@ -26338,6 +26494,11 @@ export interface Item {
    */
   structurePoints: StructurePoints
 
+  /**
+   * The burning time is the time how long the light source can be lit. After that time you have to use a new light source.
+   */
+  burningTime?: BurningTime
+
   /**
    * A list of stat blocks for each close combat technique this weapon can be used with.
    */

package/lib/types/Advantage.d.ts

@@ -851,6 +851,35 @@ export declare const Advantage: DB.Entity<"Advantage", {
                 }>, []>>>, true>;
             }>, []>>>;
         }, []>>, false>;
+        rules: DB.MemberDecl<DB.IncludeIdentifier<[], DB.TypeAlias<"SelectOptionRules", DB.Array<DB.IncludeIdentifier<[], DB.TypeAlias<"SelectOptionRule", DB.Object<{
+            value: DB.MemberDecl<DB.IncludeIdentifier<[], DB.Enum<"SelectOptionRuleValue", {
+                Predefined: DB.EnumCase<null>;
+                PredefinedOrTextInput: DB.EnumCase<DB.IncludeIdentifier<[], DB.TypeAlias<"PredefinedOrTextInputSelectOptionRuleValue", DB.Object<{
+                    translations: DB.MemberDecl<DB.NestedEntityMap<"PredefinedOrTextInputSelectOptionRuleValueTranslation", {
+                        inputLabel: DB.MemberDecl<DB.String, true>;
+                        optionLabel: DB.MemberDecl<DB.String, true>;
+                    }>, true>;
+                }>, []>>>;
+                Child: DB.EnumCase<DB.IncludeIdentifier<[], DB.TypeAlias<"ChildSelectOptionRuleValue", DB.Object<{
+                    parentIndex: DB.MemberDecl<DB.Integer, true>;
+                    entity: DB.MemberDecl<DB.IncludeIdentifier<[], DB.Enum<"ChildEntityForSelectOption", {
+                        SkillApplication: DB.EnumCase<null>;
+                    }, []>>, true>;
+                }>, []>>>;
+                TextInput: DB.EnumCase<DB.IncludeIdentifier<[], DB.TypeAlias<"TextInputSelectOptionRuleValue", DB.Object<{
+                    translations: DB.MemberDecl<DB.NestedEntityMap<"TextInputSelectOptionRuleValueTranslation", {
+                        inputLabel: DB.MemberDecl<DB.String, true>;
+                    }>, true>;
+                }>, []>>>;
+            }, []>>, true>;
+            multiple: DB.MemberDecl<DB.IncludeIdentifier<[], DB.Enum<"SelectOptionRuleMultiple", {
+                Constant: DB.EnumCase<DB.Integer>;
+                Range: DB.EnumCase<DB.Object<{
+                    min: DB.MemberDecl<DB.Integer, false>;
+                    max: DB.MemberDecl<DB.Integer, true>;
+                }>>;
+            }, []>>, false>;
+        }>, []>>>, []>>, false>;
     }>, []>>, false>;
     explicit_select_options: DB.MemberDecl<DB.ChildEntities<DB.Entity<"GeneralSelectOption", {
         parent: DB.MemberDecl<DB.IncludeIdentifier<[], DB.Enum<"SelectOptionParentIdentifier", {

package/lib/types/Advantage.js

@@ -4,7 +4,7 @@ import { ap_value, ap_value_append, ap_value_l10n } from "./_ActivatableAdventur
 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 { explicit_select_options, select_options, verifySelectOptionRules, } from "./_ActivatableSelectOptions.js";
 import { skill_applications, skill_uses } from "./_ActivatableSkillApplicationsAndUses.js";
 import { AdvantageDisadvantagePrerequisites } from "./_Prerequisite.js";
 import { NestedTranslationMap } from "./Locale.js";
@@ -58,4 +58,5 @@ export const Advantage = DB.Entity(import.meta.url, {
             keyPathInEntityMapFallback: "name",
         },
     ],
+    customConstraints: deps => verifySelectOptionRules("Advantage", deps),
 });

package/lib/types/Disadvantage.d.ts

@@ -851,6 +851,35 @@ export declare const Disadvantage: DB.Entity<"Disadvantage", {
                 }>, []>>>, true>;
             }>, []>>>;
         }, []>>, false>;
+        rules: DB.MemberDecl<DB.IncludeIdentifier<[], DB.TypeAlias<"SelectOptionRules", DB.Array<DB.IncludeIdentifier<[], DB.TypeAlias<"SelectOptionRule", DB.Object<{
+            value: DB.MemberDecl<DB.IncludeIdentifier<[], DB.Enum<"SelectOptionRuleValue", {
+                Predefined: DB.EnumCase<null>;
+                PredefinedOrTextInput: DB.EnumCase<DB.IncludeIdentifier<[], DB.TypeAlias<"PredefinedOrTextInputSelectOptionRuleValue", DB.Object<{
+                    translations: DB.MemberDecl<DB.NestedEntityMap<"PredefinedOrTextInputSelectOptionRuleValueTranslation", {
+                        inputLabel: DB.MemberDecl<DB.String, true>;
+                        optionLabel: DB.MemberDecl<DB.String, true>;
+                    }>, true>;
+                }>, []>>>;
+                Child: DB.EnumCase<DB.IncludeIdentifier<[], DB.TypeAlias<"ChildSelectOptionRuleValue", DB.Object<{
+                    parentIndex: DB.MemberDecl<DB.Integer, true>;
+                    entity: DB.MemberDecl<DB.IncludeIdentifier<[], DB.Enum<"ChildEntityForSelectOption", {
+                        SkillApplication: DB.EnumCase<null>;
+                    }, []>>, true>;
+                }>, []>>>;
+                TextInput: DB.EnumCase<DB.IncludeIdentifier<[], DB.TypeAlias<"TextInputSelectOptionRuleValue", DB.Object<{
+                    translations: DB.MemberDecl<DB.NestedEntityMap<"TextInputSelectOptionRuleValueTranslation", {
+                        inputLabel: DB.MemberDecl<DB.String, true>;
+                    }>, true>;
+                }>, []>>>;
+            }, []>>, true>;
+            multiple: DB.MemberDecl<DB.IncludeIdentifier<[], DB.Enum<"SelectOptionRuleMultiple", {
+                Constant: DB.EnumCase<DB.Integer>;
+                Range: DB.EnumCase<DB.Object<{
+                    min: DB.MemberDecl<DB.Integer, false>;
+                    max: DB.MemberDecl<DB.Integer, true>;
+                }>>;
+            }, []>>, false>;
+        }>, []>>>, []>>, false>;
     }>, []>>, false>;
     explicit_select_options: DB.MemberDecl<DB.ChildEntities<DB.Entity<"GeneralSelectOption", {
         parent: DB.MemberDecl<DB.IncludeIdentifier<[], DB.Enum<"SelectOptionParentIdentifier", {

package/lib/types/Disadvantage.js

@@ -3,7 +3,7 @@ import { input, levels, maximum, name, name_in_library, rules } from "./_Activat
 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 { explicit_select_options, select_options, verifySelectOptionRules, } from "./_ActivatableSelectOptions.js";
 import { skill_applications, skill_uses } from "./_ActivatableSkillApplicationsAndUses.js";
 import { AdvantageDisadvantagePrerequisites } from "./_Prerequisite.js";
 import { NestedTranslationMap } from "./Locale.js";
@@ -59,4 +59,5 @@ export const Disadvantage = DB.Entity(import.meta.url, {
             keyPathInEntityMapFallback: "name",
         },
     ],
+    customConstraints: deps => verifySelectOptionRules("Disadvantage", deps),
 });