Allow Damaging Items to Override Graze Damage

src/lang/en.json

@@ -579,7 +579,12 @@
                 },
                 "Damage": {
                     "Title": "Damage",
-                    "Formula": "Damage Formula"
+                    "Formula": "Damage Formula",
+                    "GrazeOverride": "Override Graze Damage Calculation",
+                    "GrazeShow": "Show New Graze Damage Formula",
+                    "GrazeHide": "Hide New Graze Damage Forumla",
+                    "GrazeFormula": "New Formula",
+                    "GrazeHint": "Formula entered here will be the entirety of the calculation for graze damage. Any die rolls will be rolled separately from the main damage roll. You can pull in all or part of the main roll using @damage.total/@damage.unmodded/@damage.dice (the latter being the system default) or the selected attribute mod with @mod"
                 },
                 "Modality": {
                     "Title": "Modality",

src/style/sheets/item/module.scss

@@ -299,6 +299,24 @@ app-item-properties {
     }
 }
 
+app-item-details-damage {
+    .form-group-stacked {
+        .header {
+            display: flex;
+            align-items: center;
+
+            label {
+                font-weight: bold;
+                flex: 2;
+            }
+
+            .controls {
+                margin-right: 0.5rem;
+            }
+        }
+    }
+}
+
 app-item-details-equip {
     .form-group-stacked {
         .header {

src/system/applications/item/components/details-damage.ts

@@ -11,6 +11,20 @@ export class DetailsDamageComponent extends HandlebarsApplicationComponent<
     static TEMPLATE =
         'systems/cosmere-rpg/templates/item/components/details-damage.hbs';
 
+    /* eslint-disable @typescript-eslint/unbound-method */
+    static ACTIONS = {
+        'toggle-graze-collapsed': DetailsDamageComponent.onToggleGrazeCollapsed,
+    };
+    /* eslint-enable @typescript-eslint/unbound-method */
+    private grazeOverrideCollapsed = true;
+
+    /* --- Actions --- */
+
+    private static onToggleGrazeCollapsed(this: DetailsDamageComponent) {
+        this.grazeOverrideCollapsed = !this.grazeOverrideCollapsed;
+        void this.render();
+    }
+
     /* --- Context --- */
 
     public _prepareContext(params: never, context: BaseItemSheetRenderContext) {
@@ -31,9 +45,15 @@ export class DetailsDamageComponent extends HandlebarsApplicationComponent<
         const hasSkill =
             hasSkillTest && this.application.item.system.activation.skill;
 
+        this.grazeOverrideCollapsed = this.application.item.system.damage
+            .grazeOverrideFormula
+            ? this.application.item.system.damage.grazeOverrideFormula === ''
+            : this.grazeOverrideCollapsed;
+
         return {
             hasSkillTest,
             hasSkill,
+            grazeInputCollapsed: this.grazeOverrideCollapsed,
 
             typeSelectOptions: {
                 none: '—',

src/system/data/item/mixins/damaging.ts

@@ -5,6 +5,7 @@ export interface DamagingItemData {
     damage: {
         formula?: string;
         type?: DamageType;
+        grazeOverrideFormula?: string;
         skill?: Skill;
         attribute?: Attribute;
     };
@@ -22,6 +23,10 @@ export function DamagingItemMixin<P extends CosmereItem>() {
                             nullable: true,
                             blank: false,
                         }),
+                        grazeOverrideFormula:
+                            new foundry.data.fields.StringField({
+                                nullable: true,
+                            }),
                         type: new foundry.data.fields.StringField({
                             nullable: true,
                             choices: Object.keys(CONFIG.COSMERE.damageTypes),

src/system/dice/damage-roll.ts

@@ -1,6 +1,7 @@
 import { DamageType, Skill, Attribute } from '@system/types/cosmere';
 import { CosmereActorRollData } from '@system/documents/actor';
 import { AdvantageMode } from '@system/types/roll';
+import RollTerm from '@league-of-foundry-developers/foundry-vtt-types/src/foundry/client-esm/dice/terms/term.mjs';
 
 export type DamageRollData<
     ActorRollData extends CosmereActorRollData = CosmereActorRollData,
@@ -15,6 +16,11 @@ export type DamageRollData<
         attribute: Attribute;
     };
     attribute?: number;
+    damage?: {
+        total: DamageRoll;
+        unmodded: DamageRoll;
+        dice: DamageRoll;
+    };
 };
 
 export interface DamageRollOptions
@@ -34,6 +40,16 @@ export interface DamageRollOptions
      * @default AdvantageMode.None
      */
     advantageMode?: AdvantageMode;
+
+    /**
+     * Where did this damage come from?
+     */
+    source?: string;
+
+    /**
+     * Nested Roll item for graze damage
+     */
+    graze?: DamageRoll;
 }
 
 export class DamageRoll extends foundry.dice.Roll<DamageRollData> {
@@ -61,6 +77,18 @@ export class DamageRoll extends foundry.dice.Roll<DamageRollData> {
         return this.options.mod;
     }
 
+    get source(): string | undefined {
+        return this.options.source;
+    }
+
+    get graze(): DamageRoll | undefined {
+        return this.options.graze;
+    }
+
+    set graze(roll: DamageRoll) {
+        this.options.graze = roll;
+    }
+
     public get hasMod() {
         return this.options.mod !== undefined;
     }
@@ -79,8 +107,52 @@ export class DamageRoll extends foundry.dice.Roll<DamageRollData> {
         return this.options.advantageMode === AdvantageMode.Disadvantage;
     }
 
+    /* --- Helper Functions --- */
+
+    public removeTermSafely(
+        conditional: (
+            value: RollTerm,
+            index: number,
+            obj: RollTerm[],
+        ) => boolean,
+    ) {
+        this.terms.findSplice(conditional);
+        this.cleanUpTerms();
+    }
+
+    public filterTermsSafely(
+        condition: (value: RollTerm, index: number, obj: RollTerm[]) => boolean,
+    ) {
+        this.terms = this.terms.filter(condition);
+        this.cleanUpTerms();
+    }
+
+    public replaceDieResults(sourceDicePool: foundry.dice.terms.DiceTerm[]) {
+        sourceDicePool.forEach((die) => {
+            let numDiceToAlter = die.number ?? 0;
+            while (numDiceToAlter > 0) {
+                const nextDie = this.dice.find(
+                    (newDie) => newDie.faces === die.faces,
+                );
+                if (!nextDie) return;
+                nextDie.results = die.results;
+                numDiceToAlter--;
+            }
+        });
+        this._total = this._evaluateTotal();
+    }
+
     /* --- Internal Functions --- */
 
+    private cleanUpTerms() {
+        while (
+            this.terms[this.terms.length - 1] instanceof
+            foundry.dice.terms.OperatorTerm
+        )
+            this.terms.pop();
+        this.resetFormula();
+    }
+
     private configureModifiers() {
         // Find the first die term
         const dieTerm = this.terms.find(

src/system/dice/index.ts

@@ -4,6 +4,7 @@ import { D20Roll, D20RollOptions, D20RollData } from './d20-roll';
 import { DamageRoll, DamageRollOptions, DamageRollData } from './damage-roll';
 import { AdvantageMode } from '../types/roll';
 import { determineConfigurationMode } from '../utils/generic';
+import { RollMode } from './types';
 
 export * from './d20-roll';
 export * from './damage-roll';
@@ -135,6 +136,7 @@ export async function damageRoll(
         allowStrings: config.allowStrings,
         maximize: config.maximize,
         minimize: config.minimize,
+        source: config.source,
     });
 
     // Evaluate the roll

src/system/documents/actor.ts

@@ -614,7 +614,9 @@ export class CosmereActor<
     public async useItem(
         item: CosmereItem,
         options?: Omit<CosmereItem.UseOptions, 'actor'>,
-    ): Promise<D20Roll | [D20Roll, DamageRoll] | null> {
+    ): Promise<D20Roll | [D20Roll, ...DamageRoll[]] | null> {
+        // Checks for relevant Active Effects triggers/manual toggles will go here
+        // E.g. permanent/conditional: attack bonuses, damage riders, auto opportunity/complications, etc.
         return item.use({ ...options, actor: this });
     }
 

src/system/documents/chat-message.ts

@@ -248,7 +248,7 @@ export class CosmereChatMessage extends ChatMessage {
                                   'COSMERE.ChatMessage.Action.ApplyGraze',
                               ),
                               icon: 'fa-solid fa-shield-halved',
-                              callback: this.onApplyDamage.bind(this, false),
+                              callback: this.onApplyDamage.bind(this),
                           },
                       ]
                     : []),
@@ -317,7 +317,7 @@ export class CosmereChatMessage extends ChatMessage {
         );
     }
 
-    private onApplyDamage(includeMod = true) {
+    private onApplyDamage() {
         // Get selected actor
         const actor = (game.canvas!.tokens!.controlled?.[0]?.actor ??
             game.user?.character) as CosmereActor | undefined;
@@ -333,13 +333,13 @@ export class CosmereChatMessage extends ChatMessage {
         // Apply damage
         void actor.applyDamage(
             ...damageRolls.map((r) => ({
-                amount: (r.total ?? 0) + (includeMod ? (r.mod ?? 0) : 0),
+                amount: r.total ?? 0,
                 type: r.damageType,
             })),
         );
     }
 
-    private onApplyHealing(includeMod = true) {
+    private onApplyHealing() {
         // Get selected actor
         const actor = (game.canvas!.tokens!.controlled?.[0]?.actor ??
             game.user?.character) as CosmereActor | undefined;
@@ -355,7 +355,7 @@ export class CosmereChatMessage extends ChatMessage {
         // Apply damage
         void actor.applyDamage(
             ...damageRolls.map((r) => ({
-                amount: (r.total ?? 0) + (includeMod ? (r.mod ?? 0) : 0),
+                amount: r.total ?? 0,
                 type: DamageType.Healing,
             })),
         );