FEAT: formatting code

FIX: fix fields used
FEAT: add jsdoc
This commit is contained in:
Joaquin Pereyra 2025-06-06 18:17:14 -03:00
parent 6c147a5c00
commit f3942280b6
13 changed files with 96 additions and 114 deletions

View file

@ -1,16 +1,30 @@
/**
* @typedef {StringFieldOptions} FormulaFieldOptions
* @property {boolean} [deterministic=false] Is this formula not allowed to have dice values?
* @typedef {foundry.data.types.StringFieldOptions} StringFieldOptions
* @typedef {foundry.data.types.DataFieldContext} DataFieldContext
*/
/**
* @typedef _FormulaFieldOptions
* @property {boolean} [deterministic] - Is this formula not allowed to have dice values?
*/
/**
* @typedef {StringFieldOptions & _FormulaFieldOptions} FormulaFieldOptions
*/
/**
* Special case StringField which represents a formula.
*
* @param {FormulaFieldOptions} [options={}] Options which configure the behavior of the field.
* @property {boolean} deterministic=false Is this formula not allowed to have dice values?
*/
export default class FormulaField extends foundry.data.fields.StringField {
/**
* @param {FormulaFieldOptions} [options] - Options which configure the behavior of the field
* @param {foundry.data.types.DataFieldContext} [context] - Additional context which describes the field
*/
constructor(options, context) {
super(options, context);
}
/** @inheritDoc */
static get _defaults() {
return foundry.utils.mergeObject(super._defaults, {
@ -24,7 +38,7 @@ export default class FormulaField extends foundry.data.fields.StringField {
_validateType(value) {
const roll = new Roll(value.replace(/@([a-z.0-9_-]+)/gi, "1"));
roll.evaluateSync({ strict: false });
if ( this.options.deterministic && !roll.isDeterministic ) throw new Error(`must not contain dice terms: ${value}`);
if (this.options.deterministic && !roll.isDeterministic) throw new Error(`must not contain dice terms: ${value}`);
super._validateType(value);
}
@ -41,7 +55,7 @@ export default class FormulaField extends foundry.data.fields.StringField {
/** @override */
_applyChangeAdd(value, delta, model, change) {
if ( !value ) return delta;
if (!value) return delta;
const operator = delta.startsWith("-") ? "-" : "+";
delta = delta.replace(/^[+-]/, "").trim();
return `${value} ${operator} ${delta}`;
@ -51,9 +65,9 @@ export default class FormulaField extends foundry.data.fields.StringField {
/** @override */
_applyChangeMultiply(value, delta, model, change) {
if ( !value ) return delta;
if (!value) return delta;
const terms = new Roll(value).terms;
if ( terms.length > 1 ) return `(${value}) * ${delta}`;
if (terms.length > 1) return `(${value}) * ${delta}`;
return `${value} * ${delta}`;
}
@ -61,9 +75,9 @@ export default class FormulaField extends foundry.data.fields.StringField {
/** @override */
_applyChangeUpgrade(value, delta, model, change) {
if ( !value ) return delta;
if (!value) return delta;
const terms = new Roll(value).terms;
if ( (terms.length === 1) && (terms[0].fn === "max") ) return value.replace(/\)$/, `, ${delta})`);
if ((terms.length === 1) && (terms[0].fn === "max")) return value.replace(/\)$/, `, ${delta})`);
return `max(${value}, ${delta})`;
}
@ -71,9 +85,9 @@ export default class FormulaField extends foundry.data.fields.StringField {
/** @override */
_applyChangeDowngrade(value, delta, model, change) {
if ( !value ) return delta;
if (!value) return delta;
const terms = new Roll(value).terms;
if ( (terms.length === 1) && (terms[0].fn === "min") ) return value.replace(/\)$/, `, ${delta})`);
if ((terms.length === 1) && (terms[0].fn === "min")) return value.replace(/\)$/, `, ${delta})`);
return `min(${value}, ${delta})`;
}
}
}