Merge branch 'restore-decorator-support_contribute-9.0'

Author: alexandrevryghem

.gitignore

@@ -42,3 +42,6 @@ yarn-error.log
 junit.xml
 
 /src/mirador-viewer/config.local.js
+
+## ignore the auto-generated decorator registries
+decorator-registries/

package.json

@@ -12,6 +12,7 @@
     "serve": "ts-node -r tsconfig-paths/register --project ./tsconfig.ts-node.json scripts/serve.ts",
     "serve:ssr": "node dist/server/main",
     "analyze": "webpack-bundle-analyzer dist/browser/stats.json",
+    "generate:decorator:registries": "ts-node --project ./tsconfig.ts-node.json scripts/generate-decorator-registries.ts",
     "build": "ng build --configuration development",
     "build:stats": "ng build --stats-json",
     "build:prod": "cross-env NODE_ENV=production npm run build:ssr",

scripts/config/decorator-config.interface.ts

@@ -0,0 +1,16 @@
+import { DecoratorParam } from './decorator-param.interface';
+
+/**
+ * The configuration for a dynamic component decorator. This is used to generate the registry files.
+ */
+export interface DecoratorConfig {
+  /**
+   * Name of the decorator
+   */
+  name: string;
+
+  /**
+   * List of DecoratorParams
+   */
+  params: DecoratorParam[];
+}

scripts/config/decorator-param.interface.ts

@@ -0,0 +1,26 @@
+/**
+ * The configuration for a decorator parameter.
+ */
+export interface DecoratorParam {
+  /**
+   * The name of the parameter
+   */
+  name: string;
+
+  /**
+   * The default value of the decorator param
+   *
+   * (Optional)
+   */
+  default?: string;
+
+  /**
+   * The property of the provided parameter value that should be used instead of the value itself.
+   *
+   * For example, if the parameter value is {@link ResourceType} 'BITSTREAM', you'll want to use 'BITSTREAM.value'
+   * instead of the whole {@link ResourceType} object. In this case the {@link DecoratorParam#property} is `value`.
+   *
+   * (Optional)
+   */
+  property?: string;
+}