feat(i18n): add options field

* Add options field that can be passed into the instance. These options then will be passed to the annotator in Preview SDK.

src/BoxAnnotations.ts

@@ -2,6 +2,11 @@ import getProp from 'lodash/get';
 import DocumentAnnotator from './document/DocumentAnnotator';
 import { Permissions, PERMISSIONS, Type } from './@types';
 
+type AnnotationsOptions = {
+    messages?: Record<string, string>;
+    locale?: string;
+};
+
 type Annotator = {
     CONSTRUCTOR: typeof DocumentAnnotator;
     NAME: string;
@@ -37,26 +42,30 @@ type ViewerOptions = Record<string, ViewerOption>;
  */
 const ANNOTATORS: Annotator[] = [
     {
-        NAME: 'Document',
         CONSTRUCTOR: DocumentAnnotator,
-        VIEWERS: ['Document', 'Presentation'],
+        NAME: 'Document',
         TYPES: [Type.region],
+        VIEWERS: ['Document', 'Presentation'],
     },
 ];
 
 class BoxAnnotations {
     annotators: Annotator[];
 
+    annotationsOptions?: AnnotationsOptions;
+
     viewerOptions?: ViewerOptions | null;
 
     /**
      * [constructor]
      *
      * @param {Object} viewerOptions - Viewer-specific annotator options
+     * @param {AnnotationsOptions } options - options passed to the annotations instance
      * @return {BoxAnnotations} BoxAnnotations instance
      */
-    constructor(viewerOptions?: ViewerOptions) {
+    constructor(viewerOptions?: ViewerOptions, options?: AnnotationsOptions) {
         this.annotators = ANNOTATORS;
+        this.annotationsOptions = options;
         this.viewerOptions = viewerOptions;
     }
 
@@ -113,6 +122,10 @@ class BoxAnnotations {
 
         return { ...annotator, TYPES: enabledTypes };
     }
+
+    getAnnotationsOptions(): AnnotationsOptions | undefined {
+        return this.annotationsOptions;
+    }
 }
 
 global.BoxAnnotations = BoxAnnotations;

src/__tests__/BoxAnnotations-test.js

@@ -157,4 +157,17 @@ describe('BoxAnnotations', () => {
             expect(loader.determineAnnotator(options, config)).toBeNull();
         });
     });
+
+    describe('getAnnotationsOptions', () => {
+        it.each([undefined, { messages: { test: 'Hello' } }])(
+            'should return the passed in options when they are %o',
+            mockOptions => {
+                loader = new BoxAnnotations(null, mockOptions);
+
+                const options = loader.getAnnotationsOptions();
+
+                expect(options).toEqual(mockOptions);
+            },
+        );
+    });
 });