Macros 2.0 expose runtime warn log function

0b529290aafd173717c5242a010fc077c607518d

Wolfsblvt <wolfsblvt@gmail.com>

public/scripts/macros/definitions/core-macros.js+2 -2 Viewed

             '{{roll::6}}',
             '{{roll::3d6+4}}',
         ],
-        handler: ({ unnamedArgs: [formula] }) => {
+        handler: ({ unnamedArgs: [formula], warn }) => {
             // If only digits were provided, treat it as `1dX`.
             if (/^\d+$/.test(formula)) {
                 formula = `1d${formula}`;

             const isValid = droll.validate(formula);
             if (!isValid) {
-                console.debug(`Invalid roll formula: ${formula}`);
+                warn(`Invalid roll formula: ${formula}`);
                 return '';
+            }

public/scripts/macros/engine/MacroRegistry.js+3 -0 Viewed

  *           Use when delayArgResolution is true. By default, preserves the caller's globalOffset so nested
  *           macros like {{pick}} maintain deterministic position-based behavior. Pass offsetDelta to add
  *           an additional offset for uniqueness (e.g., to differentiate between multiple resolve calls).
+ * @property {(message: string, error?: any) => void} warn - Logs a runtime warning with automatic macro call context.
+ *           Use this to report issues in how the macro was invoked (e.g., invalid argument values, edge cases).
  */
 /**

             resolve: (text, { offsetDelta = 0 } = {}) => MacroEngine.evaluate(text, call.env, {
                 contextOffset: call.globalOffset + offsetDelta,
             }),
+            warn: (message, error = undefined) => logMacroRuntimeWarning({ message, call, def, error }),
         };
         const result = def.handler(executionContext);