feat: add context.safe to mark a value as safe

src/Context/index.ts

@@ -16,6 +16,10 @@ import { set } from 'lodash'
 import { Macroable } from 'macroable'
 import { ContextContract } from '../Contracts'
 
+class SafeValue {
+  constructor (public value: any) {}
+}
+
 /**
  * Context is used at runtime to resolve values for a given
  * template.
@@ -105,12 +109,21 @@ export class Context extends Macroable implements ContextContract {
     this._frames.shift()
   }
 
+  /**
+   * Mark output as safe
+   */
+  public safe <T extends any> (value: T) {
+    return new SafeValue(value)
+  }
+
   /**
    * Escapes the value to be HTML safe. Only strings are escaped
    * and rest all values will be returned as it is.
    */
   public escape <T> (input: T): T {
-    return typeof (input) === 'string' ? he.escape(input) : input
+    return typeof (input) === 'string'
+      ? he.escape(input)
+      : (input instanceof SafeValue ? input.value : input)
   }
 
   /**

src/Contracts/index.ts

@@ -66,6 +66,7 @@ export interface LoaderContract {
 export interface ContextContract {
   presenter: { state: any },
   sharedState: any,
+  safe <T extends any> (value: T): { value: T },
   newFrame (): void,
   setOnFrame (key: string, value: any): void,
   removeFrame (): void,