Document or expose additional information for escaped HTML strings

[KevinGrandon]

Right now when a developer performs console.log() on a string escaped by the html method in fusion-core, it's logged as an empty object. This makes it pretty confusing, so it would be nice if

At a minimum we should have some more comments in sanitization.js. It would be nice if we could expose some additional information as enumerable keys, possibly nesting the object? Quick sketch:

    const obj = {
         description: "An escaped HTML value. Use consumeSanitizedHTML to output."
    };
    Object.defineProperty(obj, key, {
      enumerable: false,
      configurable: false,
      value: head + values.map((s, i) => escape(s) + rest[i]).join(''),
    });
return obj;

fusion-core/src/sanitization.js

Lines 36 to 42 in a6145ba

	const obj = {};
	Object.defineProperty(obj, key, {
	enumerable: false,
	configurable: false,
	value: head + values.map((s, i) => escape(s) + rest[i]).join(''),
	});
	return obj;