componentsjs 5.0.1 → 5.3.0

package/README.md

@@ -53,7 +53,7 @@ $ npm install -D componentsjs-generator
     ...
     "build": "npm run build:ts && npm run build:components",
     "build:ts": "tsc",
-    "build:components": "componentsjs-generator --typeScopedContexts",
+    "build:components": "componentsjs-generator",
     "prepare": "npm run build",
     ...
   }

package/components/context.jsonld

@@ -77,6 +77,15 @@
     "undefined": {
       "@id": "oo:isUndefined"
     },
+    "Override": {
+      "@id": "oo:Override"
+    },
+    "overrideInstance": {
+      "@id": "oo:overrideInstance"
+    },
+    "overrideParameters": {
+      "@id": "oo:overrideParameters"
+    },
     "ParameterRange": {
       "@id": "oo:ParameterRange"
     },

package/lib/ComponentsManager.d.ts

@@ -33,6 +33,10 @@ export declare class ComponentsManager<Instance> {
      * @param settings Optional settings that may influence instantiation.
      */
     instantiate<T = Instance>(instanceIri: string, settings?: IConstructionSettings): Promise<T>;
+    /**
+     * Retrieve a list of all instantiated Resources.
+     */
+    getInstantiatedResources(): Resource[];
     /**
      * Create an `componentsjs-error-state.json` file to represent the application state in the current working directory.
      * @param error The error that causes this error state to be created.

package/lib/ComponentsManager.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ComponentsManager = void 0;
 const fs = require("fs");
+const rdf_string_1 = require("rdf-string");
 const ComponentsManagerBuilder_1 = require("./loading/ComponentsManagerBuilder");
 const ErrorResourcesContext_1 = require("./util/ErrorResourcesContext");
 /**
@@ -46,6 +47,15 @@ class ComponentsManager {
             throw this.generateErrorLog(error);
         }
     }
+    /**
+     * Retrieve a list of all instantiated Resources.
+     */
+    getInstantiatedResources() {
+        const instances = this.configConstructorPool.getInstanceRegistry();
+        return Object.keys(instances)
+            .map(key => (0, rdf_string_1.stringToTerm)(key))
+            .map(term => this.configRegistry.getInstantiatedResource(term));
+    }
     /**
      * Create an `componentsjs-error-state.json` file to represent the application state in the current working directory.
      * @param error The error that causes this error state to be created.

package/lib/construction/ConfigConstructorPool.d.ts

@@ -16,7 +16,7 @@ export declare class ConfigConstructorPool<Instance> implements IConfigConstruct
     private readonly configPreprocessors;
     private readonly configConstructor;
     private readonly constructionStrategy;
-    private readonly instances;
+    private instances;
     constructor(options: IInstancePoolOptions<Instance>);
     instantiate(configResource: Resource, settings: IConstructionSettings): Promise<Instance>;
     /**
@@ -41,6 +41,14 @@ export declare class ConfigConstructorPool<Instance> implements IConfigConstruct
      * @param optional If the field is optional.
      */
     validateParam(config: Resource, field: string, type: string, optional?: boolean): void;
+    /**
+     * Returns the instance registry.
+     */
+    getInstanceRegistry(): Record<string, Promise<any>>;
+    /**
+     * Resets all preprocessors and clears the cached instances.
+     */
+    reset(): void;
 }
 export interface IInstancePoolOptions<Instance> {
     /**

package/lib/construction/ConfigConstructorPool.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConfigConstructorPool = void 0;
+const rdf_string_1 = require("rdf-string");
 const ErrorResourcesContext_1 = require("../util/ErrorResourcesContext");
 const ConfigConstructor_1 = require("./ConfigConstructor");
 /**
@@ -27,7 +28,8 @@ class ConfigConstructorPool {
         // Check if this resource is required as argument in its own chain,
         // if so, return a dummy value, to avoid infinite recursion.
         const resourceBlacklist = settings.resourceBlacklist || {};
-        if (resourceBlacklist[configResource.value]) {
+        const configResourceId = (0, rdf_string_1.termToString)(configResource.term);
+        if (resourceBlacklist[configResourceId]) {
             return Promise.reject(new ErrorResourcesContext_1.ErrorResourcesContext(`Circular dependency was detected on ${configResource.value}`, { config: configResource }));
         }
         // Before instantiating, first check if the resource is a variable
@@ -36,24 +38,24 @@ class ConfigConstructorPool {
                 .getVariableValue({ settings, variableName: configResource.value }));
         }
         // Instantiate only once
-        if (!(configResource.value in this.instances)) {
+        if (!(configResourceId in this.instances)) {
             // The blacklist avoids infinite recursion for self-referencing configs
             const subBlackList = Object.assign({}, resourceBlacklist);
-            subBlackList[configResource.value] = true;
+            subBlackList[configResourceId] = true;
             // Prepare instance parameters
             let rawConfig;
             try {
                 rawConfig = this.getRawConfig(configResource);
             }
             catch (syncError) {
-                this.instances[configResource.value] = Promise.reject(syncError);
-                return this.instances[configResource.value];
+                this.instances[configResourceId] = Promise.reject(syncError);
+                return this.instances[configResourceId];
             }
             const subSettings = Object.assign(Object.assign({}, settings), { resourceBlacklist: subBlackList });
             // Invoke instance creation
-            this.instances[configResource.value] = this.configConstructor.createInstance(rawConfig, subSettings);
+            this.instances[configResourceId] = this.configConstructor.createInstance(rawConfig, subSettings);
         }
-        return this.instances[configResource.value];
+        return this.instances[configResourceId];
     }
     /**
      * Determine the raw config of the given config.
@@ -67,9 +69,12 @@ class ConfigConstructorPool {
         for (const rawConfigFactory of this.configPreprocessors) {
             const handleResponse = rawConfigFactory.canHandle(config);
             if (handleResponse) {
-                const rawConfig = rawConfigFactory.transform(config, handleResponse);
-                this.validateRawConfig(rawConfig);
-                return rawConfig;
+                const { rawConfig, finishTransformation } = rawConfigFactory.transform(config, handleResponse);
+                if (finishTransformation) {
+                    this.validateRawConfig(rawConfig);
+                    return rawConfig;
+                }
+                config = rawConfig;
             }
         }
         // If none can handle it, just return the original config
@@ -106,6 +111,21 @@ class ConfigConstructorPool {
             throw new ErrorResourcesContext_1.ErrorResourcesContext(`Invalid config: ${field} "${config.property[field].value}" must be a ${type}, but got ${config.property[field].type}`, { config });
         }
     }
+    /**
+     * Returns the instance registry.
+     */
+    getInstanceRegistry() {
+        return this.instances;
+    }
+    /**
+     * Resets all preprocessors and clears the cached instances.
+     */
+    reset() {
+        this.instances = {};
+        for (const preprocessor of this.configPreprocessors) {
+            preprocessor.reset();
+        }
+    }
 }
 exports.ConfigConstructorPool = ConfigConstructorPool;
 //# sourceMappingURL=ConfigConstructorPool.js.map

package/lib/construction/IConfigConstructorPool.d.ts

@@ -11,4 +11,14 @@ export interface IConfigConstructorPool<Instance> {
      * @returns {any} The run instance.
      */
     instantiate: (configResource: Resource, settings: IConstructionSettings) => Promise<Instance>;
+    /**
+     * Return the instance regsitry.
+     * This is a hash from registered id to a Promise of the Instance.
+     */
+    getInstanceRegistry: () => Record<string, Promise<Instance>>;
+    /**
+     * Resets any internal state to what it originally was.
+     * Used when new components are added inbetween 2 instantiations.
+     */
+    reset: () => void;
 }

package/lib/loading/ComponentsManagerBuilder.js

@@ -9,6 +9,7 @@ const ConfigConstructorPool_1 = require("../construction/ConfigConstructorPool")
 const ConstructionStrategyCommonJs_1 = require("../construction/strategy/ConstructionStrategyCommonJs");
 const ConfigPreprocessorComponent_1 = require("../preprocess/ConfigPreprocessorComponent");
 const ConfigPreprocessorComponentMapped_1 = require("../preprocess/ConfigPreprocessorComponentMapped");
+const ConfigPreprocessorOverride_1 = require("../preprocess/ConfigPreprocessorOverride");
 const ParameterHandler_1 = require("../preprocess/ParameterHandler");
 const ComponentRegistry_1 = require("./ComponentRegistry");
 const ComponentRegistryFinalizer_1 = require("./ComponentRegistryFinalizer");
@@ -99,6 +100,11 @@ class ComponentsManagerBuilder {
         const configConstructorPool = new ConfigConstructorPool_1.ConfigConstructorPool({
             objectLoader,
             configPreprocessors: [
+                new ConfigPreprocessorOverride_1.ConfigPreprocessorOverride({
+                    objectLoader,
+                    componentResources,
+                    logger: this.logger,
+                }),
                 new ConfigPreprocessorComponentMapped_1.ConfigPreprocessorComponentMapped({
                     objectLoader,
                     runTypeConfigs,

package/lib/loading/ConfigRegistry.d.ts

@@ -1,7 +1,7 @@
 /// <reference types="node" />
 import type { Readable } from 'stream';
 import type * as RDF from '@rdfjs/types';
-import type { RdfObjectLoader } from 'rdf-object';
+import type { RdfObjectLoader, Resource } from 'rdf-object';
 import type { Logger } from 'winston';
 import type { IModuleState } from './ModuleStateBuilder';
 /**
@@ -30,6 +30,11 @@ export declare class ConfigRegistry {
      * @param params A dictionary with named parameters.
      */
     registerCustom(configId: string, componentTypeIri: string, params: Record<string, string>): Promise<void>;
+    /**
+     * Get the instantiated Resource that was registered to the given term.
+     * @param term The term of the Resource that was instantiated
+     */
+    getInstantiatedResource(term: RDF.Term): Resource;
 }
 export interface IConfigLoaderRegistryOptions {
     moduleState: IModuleState;

package/lib/loading/ConfigRegistry.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ConfigRegistry = void 0;
+const rdf_string_1 = require("rdf-string");
 const RdfParser_1 = require("../rdf/RdfParser");
 /**
  * Accepts registrations for configurations that contain instantiations of components.
@@ -50,6 +51,13 @@ class ConfigRegistry {
             configResource.property[key] = this.objectLoader.createCompactedResource(`"${params[key]}"`);
         }
     }
+    /**
+     * Get the instantiated Resource that was registered to the given term.
+     * @param term The term of the Resource that was instantiated
+     */
+    getInstantiatedResource(term) {
+        return this.objectLoader.resources[(0, rdf_string_1.termToString)(term)];
+    }
 }
 exports.ConfigRegistry = ConfigRegistry;
 //# sourceMappingURL=ConfigRegistry.js.map

package/lib/preprocess/ConfigPreprocessorComponent.d.ts

@@ -1,7 +1,7 @@
 import type { Resource, RdfObjectLoader } from 'rdf-object';
 import type { Logger } from 'winston';
 import { GenericsContext } from './GenericsContext';
-import type { IConfigPreprocessor } from './IConfigPreprocessor';
+import type { IConfigPreprocessorTransform, IConfigPreprocessor } from './IConfigPreprocessor';
 import type { ParameterHandler } from './ParameterHandler';
 /**
  * Handles config that refer to a component as type.
@@ -15,7 +15,7 @@ export declare class ConfigPreprocessorComponent implements IConfigPreprocessor<
     protected readonly logger: Logger;
     constructor(options: IComponentConfigPreprocessorOptions);
     canHandle(config: Resource): IComponentConfigPreprocessorHandleResponse | undefined;
-    transform(config: Resource, handleResponse: IComponentConfigPreprocessorHandleResponse): Resource;
+    transform(config: Resource, handleResponse: IComponentConfigPreprocessorHandleResponse): IConfigPreprocessorTransform;
     protected createGenericsContext(handleResponse: IComponentConfigPreprocessorHandleResponse, config: Resource): GenericsContext;
     /**
      * Determine the constructor arguments of the given config.
@@ -43,6 +43,7 @@ export declare class ConfigPreprocessorComponent implements IConfigPreprocessor<
      * @param handleResponse The handle response.
      */
     validateConfig(config: Resource, handleResponse: IComponentConfigPreprocessorHandleResponse): void;
+    reset(): void;
 }
 export interface IComponentConfigPreprocessorOptions {
     objectLoader: RdfObjectLoader;

package/lib/preprocess/ConfigPreprocessorComponent.js

@@ -86,7 +86,7 @@ class ConfigPreprocessorComponent {
         configRaw.property.arguments = this.transformConstructorArguments(config, handleResponse);
         // Validate the input config
         this.validateConfig(config, handleResponse);
-        return configRaw;
+        return { rawConfig: configRaw, finishTransformation: true };
     }
     createGenericsContext(handleResponse, config) {
         // Create a new generics context for the component's generic type parameters
@@ -245,6 +245,9 @@ class ConfigPreprocessorComponent {
             }
         }
     }
+    reset() {
+        // There is nothing to reset here
+    }
 }
 exports.ConfigPreprocessorComponent = ConfigPreprocessorComponent;
 //# sourceMappingURL=ConfigPreprocessorComponent.js.map

package/lib/preprocess/ConfigPreprocessorOverride.d.ts

@@ -0,0 +1,92 @@
+import type { Resource } from 'rdf-object';
+import type { RdfObjectLoader } from 'rdf-object/lib/RdfObjectLoader';
+import type { Logger } from 'winston';
+import type { IConfigPreprocessor, IConfigPreprocessorTransform } from './IConfigPreprocessor';
+/**
+ * An {@link IConfigPreprocessor} that handles the overriding of parameters.
+ * Values in the given {@link Resource}s will be replaced if any overriding object is found,
+ * targeting this resource.
+ */
+export declare class ConfigPreprocessorOverride implements IConfigPreprocessor<Record<string, Resource>> {
+    readonly objectLoader: RdfObjectLoader;
+    readonly componentResources: Record<string, Resource>;
+    readonly logger: Logger;
+    private overrides;
+    constructor(options: IComponentConfigPreprocessorOverrideOptions);
+    /**
+     * Checks if there are any overrides targeting the given resource.
+     * @param config - Resource to find overrides for.
+     *
+     * @returns A key/value object with keys being the properties that have an override.
+     */
+    canHandle(config: Resource): Record<string, Resource> | undefined;
+    /**
+     * Override the resource with the stored values.
+     * @param config - The resource to override.
+     * @param handleResponse - Override values that were found for this resource.
+     */
+    transform(config: Resource, handleResponse: Record<string, Resource>): IConfigPreprocessorTransform;
+    /**
+     * Clear all cached overrides so they will be calculated again on the next call.
+     */
+    reset(): void;
+    /**
+     * Generates a cache of all overrides found in the object loader.
+     * Keys of the object are the identifiers of the resources that need to be modified,
+     * values are key/value maps listing all parameters with their new values.
+     */
+    createOverrideObjects(): Record<string, Record<string, Resource>>;
+    /**
+     * Finds all Override resources in the object loader and links them to their target resource.
+     */
+    protected findOverrideTargets(): Iterable<{
+        override: Resource;
+        target: Resource;
+    }>;
+    /**
+     * Chains all Overrides together if they reference each other.
+     * E.g., if the input is a list of Overrides A -> B, B -> C, D -> E,
+     * the result wil be [[ A, B, C ], [ D, E ]].
+     *
+     * @param overrides - All Overrides that have to be combined.
+     */
+    protected createOverrideChains(overrides: {
+        override: Resource;
+        target: Resource;
+    }[]): Resource[][];
+    /**
+     * Throws an error in case there are 2 chains targeting the same resource.
+     * @param chains - The override chains to check.
+     */
+    protected validateChains(chains: Resource[][]): void;
+    /**
+     * Merges all Overrides in a chain to create a single override object
+     * containing replacement values for all relevant parameters of the final entry in the chain.
+     *
+     * @param chain - The chain of Overrides, with a normal resource as the last entry in the array.
+     */
+    protected chainToOverrideObject(chain: Resource[]): {
+        target: string;
+        values: Record<string, Resource>;
+    };
+    /**
+     * Finds the final target and its type in an override chain.
+     * @param chain - The chain to find the target of.
+     */
+    protected getChainTarget(chain: Resource[]): {
+        target: Resource;
+        type: Resource;
+    };
+    /**
+     * Extracts all relevant parameters of an Override with their corresponding new value.
+     * @param override - The Override to apply.
+     * @param target - The target resource to apply the Override to.
+     * @param parameters - The parameters that are relevant for the target.
+     */
+    protected filterOverrideObject(override: Resource, target: Resource, parameters: Resource[]): Record<string, Resource>;
+}
+export interface IComponentConfigPreprocessorOverrideOptions {
+    objectLoader: RdfObjectLoader;
+    componentResources: Record<string, Resource>;
+    logger: Logger;
+}

package/lib/preprocess/ConfigPreprocessorOverride.js

@@ -0,0 +1,222 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigPreprocessorOverride = void 0;
+const ErrorResourcesContext_1 = require("../util/ErrorResourcesContext");
+/**
+ * An {@link IConfigPreprocessor} that handles the overriding of parameters.
+ * Values in the given {@link Resource}s will be replaced if any overriding object is found,
+ * targeting this resource.
+ */
+class ConfigPreprocessorOverride {
+    constructor(options) {
+        this.objectLoader = options.objectLoader;
+        this.componentResources = options.componentResources;
+        this.logger = options.logger;
+    }
+    /**
+     * Checks if there are any overrides targeting the given resource.
+     * @param config - Resource to find overrides for.
+     *
+     * @returns A key/value object with keys being the properties that have an override.
+     */
+    canHandle(config) {
+        if (!this.overrides) {
+            this.overrides = this.createOverrideObjects();
+        }
+        return this.overrides[config.value];
+    }
+    /**
+     * Override the resource with the stored values.
+     * @param config - The resource to override.
+     * @param handleResponse - Override values that were found for this resource.
+     */
+    transform(config, handleResponse) {
+        for (const id of Object.keys(config.properties)) {
+            const overrideValue = handleResponse[id];
+            if (overrideValue) {
+                config.properties[id] = [overrideValue];
+            }
+        }
+        return { rawConfig: config, finishTransformation: false };
+    }
+    /**
+     * Clear all cached overrides so they will be calculated again on the next call.
+     */
+    reset() {
+        this.overrides = undefined;
+    }
+    /**
+     * Generates a cache of all overrides found in the object loader.
+     * Keys of the object are the identifiers of the resources that need to be modified,
+     * values are key/value maps listing all parameters with their new values.
+     */
+    createOverrideObjects() {
+        const overrides = [...this.findOverrideTargets()];
+        const chains = this.createOverrideChains(overrides);
+        this.validateChains(chains);
+        const overrideObjects = {};
+        for (const chain of chains) {
+            const { target, values } = this.chainToOverrideObject(chain);
+            if (Object.keys(values).length > 0) {
+                overrideObjects[target] = values;
+            }
+        }
+        return overrideObjects;
+    }
+    /**
+     * Finds all Override resources in the object loader and links them to their target resource.
+     */
+    *findOverrideTargets() {
+        const overrideUri = this.objectLoader.contextResolved.expandTerm('oo:Override');
+        const overrideInstanceUri = this.objectLoader.contextResolved.expandTerm('oo:overrideInstance');
+        for (const [id, resource] of Object.entries(this.objectLoader.resources)) {
+            if (resource.isA(overrideUri) && resource.value !== overrideUri) {
+                const targets = resource.properties[overrideInstanceUri];
+                if (!targets || targets.length === 0) {
+                    this.logger.warn(`Missing overrideInstance for ${id}. This Override will be ignored.`);
+                    continue;
+                }
+                if (targets.length > 1) {
+                    throw new ErrorResourcesContext_1.ErrorResourcesContext(`Detected multiple overrideInstance targets for ${id}`, {
+                        override: resource,
+                    });
+                }
+                yield { override: resource, target: targets[0] };
+            }
+        }
+    }
+    /**
+     * Chains all Overrides together if they reference each other.
+     * E.g., if the input is a list of Overrides A -> B, B -> C, D -> E,
+     * the result wil be [[ A, B, C ], [ D, E ]].
+     *
+     * @param overrides - All Overrides that have to be combined.
+     */
+    createOverrideChains(overrides) {
+        // Start by creating small chains: from each override to its immediate target
+        const overrideChains = Object.fromEntries(overrides.map(({ override, target }) => [override.value, [override, target]]));
+        // Then keep combining those smaller chains into bigger chains until they are complete.
+        // If there is an override cycle (A -> B -> ... -> A) it will delete itself from the list of chains here.
+        let change = true;
+        while (change) {
+            change = false;
+            for (const [id, chain] of Object.entries(overrideChains)) {
+                let next = chain[chain.length - 1];
+                // If the next part of the chain is found in `overrideChains` we can merge them and remove the tail entry
+                while (overrideChains[next.value]) {
+                    change = true;
+                    const nextChain = overrideChains[next.value];
+                    // First element of nextChain will be equal to last element of this chain
+                    overrideChains[id].push(...nextChain.slice(1));
+                    // In case of a cycle there will be a point where next equals the first element,
+                    // at which point it will delete itself.
+                    delete overrideChains[next.value];
+                    next = chain[chain.length - 1];
+                }
+                // Reset the loop since we are modifying the object we are iterating over
+                if (change) {
+                    break;
+                }
+            }
+        }
+        return Object.values(overrideChains);
+    }
+    /**
+     * Throws an error in case there are 2 chains targeting the same resource.
+     * @param chains - The override chains to check.
+     */
+    validateChains(chains) {
+        const targets = chains.map((chain) => chain[chain.length - 1].value);
+        for (let i = 0; i < targets.length; ++i) {
+            const duplicateIdx = targets.findIndex((target, idx) => idx > i && target === targets[i]);
+            if (duplicateIdx > 0) {
+                const target = chains[i][chains[i].length - 1];
+                const duplicate1 = chains[i][chains[i].length - 2];
+                const duplicate2 = chains[duplicateIdx][chains[duplicateIdx].length - 2];
+                throw new ErrorResourcesContext_1.ErrorResourcesContext(`Found multiple Overrides targeting ${targets[i]}`, {
+                    target,
+                    overrides: [duplicate1, duplicate2],
+                });
+            }
+        }
+    }
+    /**
+     * Merges all Overrides in a chain to create a single override object
+     * containing replacement values for all relevant parameters of the final entry in the chain.
+     *
+     * @param chain - The chain of Overrides, with a normal resource as the last entry in the array.
+     */
+    chainToOverrideObject(chain) {
+        const { target, type } = this.getChainTarget(chain);
+        // Apply all overrides sequentially, starting from the one closest to the target.
+        // This ensures the most recent override has priority.
+        const parameters = this.componentResources[type.value].properties.parameters;
+        const mergedOverride = {};
+        for (let i = chain.length - 2; i >= 0; --i) {
+            const filteredObject = this.filterOverrideObject(chain[i], target, parameters);
+            Object.assign(mergedOverride, filteredObject);
+        }
+        return { target: target.value, values: mergedOverride };
+    }
+    /**
+     * Finds the final target and its type in an override chain.
+     * @param chain - The chain to find the target of.
+     */
+    getChainTarget(chain) {
+        const rdfTypeUri = this.objectLoader.contextResolved.expandTerm('rdf:type');
+        const target = chain[chain.length - 1];
+        const types = target.properties[rdfTypeUri];
+        if (!types || types.length === 0) {
+            throw new ErrorResourcesContext_1.ErrorResourcesContext(`Missing type for override target ${target.value} of Override ${chain[chain.length - 2].value}`, {
+                target,
+                override: chain[chain.length - 2],
+            });
+        }
+        if (types.length > 1) {
+            throw new ErrorResourcesContext_1.ErrorResourcesContext(`Found multiple types for override target ${target.value} of Override ${chain[chain.length - 2].value}`, {
+                target,
+                override: chain[chain.length - 2],
+            });
+        }
+        return { target, type: types[0] };
+    }
+    /**
+     * Extracts all relevant parameters of an Override with their corresponding new value.
+     * @param override - The Override to apply.
+     * @param target - The target resource to apply the Override to.
+     * @param parameters - The parameters that are relevant for the target.
+     */
+    filterOverrideObject(override, target, parameters) {
+        const overrideParametersUri = this.objectLoader.contextResolved.expandTerm('oo:overrideParameters');
+        const overrideObjects = override.properties[overrideParametersUri];
+        if (!overrideObjects || overrideObjects.length === 0) {
+            this.logger.warn(`No overrideParameters found for ${override.value}.`);
+            return {};
+        }
+        if (overrideObjects.length > 1) {
+            throw new ErrorResourcesContext_1.ErrorResourcesContext(`Detected multiple values for overrideParameters in Override ${override.value}`, {
+                override,
+            });
+        }
+        const overrideObject = overrideObjects[0];
+        // Only keep the parameters that are known to the type of the target object
+        const filteredObject = {};
+        for (const parameter of parameters) {
+            const overrideValues = overrideObject.properties[parameter.value];
+            if (!overrideValues || overrideValues.length === 0) {
+                continue;
+            }
+            if (overrideValues.length > 1) {
+                throw new ErrorResourcesContext_1.ErrorResourcesContext(`Detected multiple values for override parameter ${parameter.value} in Override ${override.value}. RDF lists should be used for defining multiple values.`, {
+                    arguments: overrideValues,
+                    target,
+                    override,
+                });
+            }
+            filteredObject[parameter.value] = overrideValues[0];
+        }
+        return filteredObject;
+    }
+}
+exports.ConfigPreprocessorOverride = ConfigPreprocessorOverride;
+//# sourceMappingURL=ConfigPreprocessorOverride.js.map

package/lib/preprocess/IConfigPreprocessor.d.ts

@@ -1,4 +1,14 @@
 import type { Resource } from 'rdf-object';
+export interface IConfigPreprocessorTransform {
+    /**
+     * If the result is final or other preprocessors are allowed to continue.
+     */
+    finishTransformation: boolean;
+    /**
+     * The result of the transform.
+     */
+    rawConfig: Resource;
+}
 /**
  * Transforms an enhanced config of a certain form into a raw config
  * so that it can be instantiated by {@link ConfigConstructor}.
@@ -14,5 +24,10 @@ export interface IConfigPreprocessor<HR> {
      * @param config Config to transform.
      * @param handleResponse Return value of the {#canHandle}.
      */
-    transform: (config: Resource, handleResponse: HR) => Resource;
+    transform: (config: Resource, handleResponse: HR) => IConfigPreprocessorTransform;
+    /**
+     * Resets any internal state to what it originally was.
+     * Used when new components are added inbetween 2 instantiations.
+     */
+    reset: () => void;
 }

package/lib/preprocess/parameterproperty/ParameterPropertyHandlerRange.d.ts

@@ -33,6 +33,11 @@ export declare class ParameterPropertyHandlerRange implements IParameterProperty
      * @return IParamValueConflict A conflict value if there was an error, or undefined if there was no error
      */
     hasValueType(value: Resource | undefined, type: Resource | undefined, errorContext: IErrorContext, genericsContext: GenericsContext): IParamValueConflict | undefined;
+    /**
+     * Utility function for handling Literals.
+     * If the provided value represents a valid Literal, the `valueRaw` field will be set.
+     */
+    private interpretValueAsType;
     static throwIncorrectTypeError(value: Resource | undefined, parameter: Resource, genericsContext: GenericsContext, conflict: IParamValueConflict): never;
     /**
      * Check if the given value is of the given type.
@@ -54,3 +59,13 @@ export interface IParamValueConflict {
     context: IErrorContext;
     causes?: IParamValueConflict[];
 }
+/**
+ * Represents the result of an interpretValuesAsType operation.
+ */
+export interface ILiteralAsTypeInterpretationResult {
+    /**
+     * Value is true if a matching literal type was found.
+     */
+    match: boolean;
+    value?: IParamValueConflict;
+}

package/lib/preprocess/parameterproperty/ParameterPropertyHandlerRange.js

@@ -53,6 +53,11 @@ class ParameterPropertyHandlerRange {
             return;
         }
         if (type.isA('ParameterRangeWildcard')) {
+            if (value && value.term.termType === 'Literal') {
+                // Get datatype of the configured value
+                const configuredDataType = value.term.datatype;
+                return this.interpretValueAsType(value, configuredDataType, errorContext, genericsContext).value;
+            }
             return;
         }
         if (!value && type.isA('ParameterRangeUndefined')) {
@@ -64,69 +69,10 @@ class ParameterPropertyHandlerRange {
         }
         // Handle literal values
         if (value && value.type === 'Literal') {
-            let parsed;
-            switch (type.value) {
-                case Iris_1.IRIS_XSD.string:
-                    return;
-                case Iris_1.IRIS_XSD.boolean:
-                    if (value.value === 'true') {
-                        value.term.valueRaw = true;
-                    }
-                    else if (value.value === 'false') {
-                        value.term.valueRaw = false;
-                    }
-                    else {
-                        return {
-                            description: 'value must either be "true" or "false"',
-                            context: errorContext,
-                        };
-                    }
-                    return;
-                case Iris_1.IRIS_XSD.integer:
-                case Iris_1.IRIS_XSD.number:
-                case Iris_1.IRIS_XSD.int:
-                case Iris_1.IRIS_XSD.byte:
-                case Iris_1.IRIS_XSD.long:
-                    parsed = Number.parseInt(value.value, 10);
-                    if (Number.isNaN(parsed)) {
-                        return {
-                            description: `value is not a number`,
-                            context: errorContext,
-                        };
-                    }
-                    // ParseInt also parses floats to ints!
-                    if (String(parsed) !== value.value) {
-                        return {
-                            description: `value can not be a float`,
-                            context: errorContext,
-                        };
-                    }
-                    value.term.valueRaw = parsed;
-                    return;
-                case Iris_1.IRIS_XSD.float:
-                case Iris_1.IRIS_XSD.decimal:
-                case Iris_1.IRIS_XSD.double:
-                    parsed = Number.parseFloat(value.value);
-                    if (Number.isNaN(parsed)) {
-                        return {
-                            description: `value is not a number`,
-                            context: errorContext,
-                        };
-                    }
-                    value.term.valueRaw = parsed;
-                    return;
-                case Iris_1.IRIS_RDF.JSON:
-                    try {
-                        parsed = JSON.parse(value.value);
-                        value.term.valueRaw = parsed;
-                    }
-                    catch (error) {
-                        return {
-                            description: `JSON parse exception: ${error.message}`,
-                            context: errorContext,
-                        };
-                    }
-                    return;
+            const result = this.interpretValueAsType(value, type, errorContext, genericsContext);
+            if (result.match) {
+                // Stop processing and return (with a possible IParamValueConflict) if a match was found.
+                return result.value;
             }
         }
         // Allow IRIs to be casted to strings
@@ -359,6 +305,93 @@ class ParameterPropertyHandlerRange {
         }
         return hasTypeConflict || { description: 'unknown parameter type', context: errorContext };
     }
+    /**
+     * Utility function for handling Literals.
+     * If the provided value represents a valid Literal, the `valueRaw` field will be set.
+     */
+    interpretValueAsType(value, type, errorContext, genericsContext) {
+        let parsed;
+        switch (type.value) {
+            case Iris_1.IRIS_XSD.string:
+                return { match: true };
+            case Iris_1.IRIS_XSD.boolean:
+                if (value.value === 'true') {
+                    value.term.valueRaw = true;
+                }
+                else if (value.value === 'false') {
+                    value.term.valueRaw = false;
+                }
+                else {
+                    return {
+                        match: true,
+                        value: {
+                            description: 'value must either be "true" or "false"',
+                            context: errorContext,
+                        },
+                    };
+                }
+                return { match: true };
+            case Iris_1.IRIS_XSD.integer:
+            case Iris_1.IRIS_XSD.number:
+            case Iris_1.IRIS_XSD.int:
+            case Iris_1.IRIS_XSD.byte:
+            case Iris_1.IRIS_XSD.long:
+                parsed = Number.parseInt(value.value, 10);
+                if (Number.isNaN(parsed)) {
+                    return {
+                        match: true,
+                        value: {
+                            description: `value is not a number`,
+                            context: errorContext,
+                        },
+                    };
+                }
+                // ParseInt also parses floats to ints!
+                if (String(parsed) !== value.value) {
+                    return {
+                        match: true,
+                        value: {
+                            description: `value can not be a float`,
+                            context: errorContext,
+                        },
+                    };
+                }
+                value.term.valueRaw = parsed;
+                return { match: true };
+            case Iris_1.IRIS_XSD.float:
+            case Iris_1.IRIS_XSD.decimal:
+            case Iris_1.IRIS_XSD.double:
+                parsed = Number.parseFloat(value.value);
+                if (Number.isNaN(parsed)) {
+                    return {
+                        match: true,
+                        value: {
+                            description: `value is not a number`,
+                            context: errorContext,
+                        },
+                    };
+                }
+                value.term.valueRaw = parsed;
+                return { match: true };
+            case Iris_1.IRIS_RDF.JSON:
+                try {
+                    parsed = JSON.parse(value.value);
+                    value.term.valueRaw = parsed;
+                }
+                catch (error) {
+                    return {
+                        match: true,
+                        value: {
+                            description: `JSON parse exception: ${error.message}`,
+                            context: errorContext,
+                        },
+                    };
+                }
+                return { match: true };
+            default:
+                return { match: false };
+        }
+    }
     static throwIncorrectTypeError(value, parameter, genericsContext, conflict) {
         const withTypes = value && value.properties.types.length > 0 ? ` with types "${value.properties.types.map(resource => resource.value)}"` : '';
         // eslint-disable-next-line @typescript-eslint/no-extra-parens

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "componentsjs",
-  "version": "5.0.1",
+  "version": "5.3.0",
   "description": "A semantic dependency injection framework",
   "lsd:contexts": {
     "https://linkedsoftwaredependencies.org/bundles/npm/componentsjs/^5.0.0/components/context.jsonld": "components/context.jsonld"
@@ -43,15 +43,16 @@
     "rdf-object": "^1.13.1",
     "rdf-parse": "^2.0.0",
     "rdf-quad": "^1.5.0",
+    "rdf-string": "^1.6.0",
     "rdf-terms": "^1.7.0",
     "semver": "^7.3.2",
     "winston": "^3.3.3"
   },
   "devDependencies": {
     "@rubensworks/eslint-config": "^1.0.1",
+    "@types/jest": "^27.0.0",
     "@typescript-eslint/eslint-plugin": "^5.0.0",
     "@typescript-eslint/parser": "^5.0.0",
-    "@types/jest": "^27.0.0",
     "eslint": "^7.12.1",
     "eslint-config-es": "3.25.3",
     "eslint-import-resolver-typescript": "^2.3.0",

package/CHANGELOG.md

@@ -1,314 +0,0 @@
-# Changelog
-All notable changes to this project will be documented in this file.
-
-<a name="v5.0.1"></a>
-## [v5.0.1](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v5.0.0...v5.0.1) - 2022-03-02
-
-### Changed
-* [Bump to rdf-parse 2](https://github.com/LinkedSoftwareDependencies/Components.js/commit/5957c21d9ea0d8e6086be09d67ee99e64f8b2960)
-
-<a name="v5.0.0"></a>
-## [v5.0.0](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v5.0.0-beta.7...v5.0.0) - 2022-03-01
-
-### Changed
-* [Bump context URL to 5.0.0](https://github.com/LinkedSoftwareDependencies/Components.js/commit/495654fa70f559aaaa86a0960686fd1ca23f9546)
-* [Add incorrect version number as possible cause for remote lookup failure (#67)](https://github.com/LinkedSoftwareDependencies/Components.js/commit/adf1d7e092b95a2fc47c7d2da3dfe191fdb741aa)
-
-<a name="v5.0.0-beta.7"></a>
-## [v5.0.0-beta.7](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v5.0.0-beta.6...v5.0.0-beta.7) - 2022-02-21
-
-### Changed
-* [Lower log level of empty modules to debug](https://github.com/LinkedSoftwareDependencies/Components.js/commit/df119861bc12992e05af05b42f0a734069de6915)
-* [Bump to rdf-object 1.13.1](https://github.com/LinkedSoftwareDependencies/Components.js/commit/264be522079f86bd47bea9fe5730eaed29bbe450)
-
-### Fixed
-* [Fix incorrect error logging when generics error occurs in extends clause](https://github.com/LinkedSoftwareDependencies/Components.js/commit/1ce62d39896ca498ecba7443c9c7c298c9db0301)
-* [Fix minor context issues](https://github.com/LinkedSoftwareDependencies/Components.js/commit/7adcd5fe0de73a42c8225069752be40214f843f3)
-
-<a name="v5.0.0-beta.6"></a>
-## [v5.0.0-beta.6](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v5.0.0-beta.5...v5.0.0-beta.6) - 2022-02-09
-
-### Fixed
-* [Fix generic errors still throwing during ignored type checking](https://github.com/LinkedSoftwareDependencies/Components.js/commit/c14adcf4757e5194db22c0f0285407bd03bf5635)
-
-<a name="v5.0.0-beta.5"></a>
-## [v5.0.0-beta.5](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v5.0.0-beta.4...v5.0.0-beta.5) - 2022-02-08
-
-### Added
-* [Allow type-checking to be disabled via typeChecking](https://github.com/LinkedSoftwareDependencies/Components.js/commit/a55331085e4c5621832e6b23bc52b00068e8256a)
-
-### Changed
-* [Throw error on circular dependencies, Closes #53](https://github.com/LinkedSoftwareDependencies/Components.js/commit/e7a28d1cf87d96d5b58bb6d1f19ce41d6e55aab6)
-
-### Fixed
-* [Fix seeAlso links not handling encoded URI components, Closes #43](https://github.com/LinkedSoftwareDependencies/Components.js/commit/2b72914d2720b2982d4570af55f9b5d7dc196c27)
-
-<a name="v5.0.0-beta.4"></a>
-## [v5.0.0-beta.4](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v5.0.0-beta.3...v5.0.0-beta.4) - 2022-01-29
-
-### Added
-* [Support ParameterRangeIndexed for fixed literals](https://github.com/LinkedSoftwareDependencies/Components.js/commit/0d97782a4a8dcca9fc5bbb3389a4213eca5a5205)
-
-### Changed
-* [Propagate original error messages to require calls, Closes #65](https://github.com/LinkedSoftwareDependencies/Components.js/commit/8934ec9b784def601730b3d3f2e60c4ff0b8776e)
-* [Include config id in invalid param error message](https://github.com/LinkedSoftwareDependencies/Components.js/commit/e724f44e2222eb9917da3b227e2ce0dc9cde15f9)
-* [Update memberKeys to memberFields](https://github.com/LinkedSoftwareDependencies/Components.js/commit/2c7437e1519c1813fb1a29f50d7c20bdbdf7f06e)
-
-<a name="v5.0.0-beta.3"></a>
-## [v5.0.0-beta.3](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v5.0.0-beta.2...v5.0.0-beta.3) - 2022-01-17
-
-### Added
-* [Add support for wildcard parameter ranges](https://github.com/LinkedSoftwareDependencies/Components.js/commit/83238a9fa08877f29326be562d7d3d5fff860c69)
-* Improve error reporting:
-  * [Add causes for param check failures in error messages](https://github.com/LinkedSoftwareDependencies/Components.js/commit/9be1fd0899ffb8a77ea99e5fb86e661526ef6d1a)
-  * [Improve error message on invalid generic type instantiations](https://github.com/LinkedSoftwareDependencies/Components.js/commit/6ecb9798eeb84f09fece68b3a47454fa8c857ba4)
-  * [Move error context to error state file](https://github.com/LinkedSoftwareDependencies/Components.js/commit/dbf26e072bdc63168814ef4d503777efaf4745eb)
-
-### Fixed
-* Resolve several issues related to generics:
-  * [Throw error on invalid ParameterRangeGenericComponent](https://github.com/LinkedSoftwareDependencies/Components.js/commit/c692ab6175ce466fb32fbe38b973644e2601b2e6)
-  * [Fix generic components not accepting specific types](https://github.com/LinkedSoftwareDependencies/Components.js/commit/c7739182fddcb92d46a86fe3e33d6e29fd1134b6)
-  * [Support generic type instantiation during component extension](https://github.com/LinkedSoftwareDependencies/Components.js/commit/98f70e350cc3f9bf8a4ea632db546f74624ddda7)
-  * [Support generic components in params with fixed generics](https://github.com/LinkedSoftwareDependencies/Components.js/commit/d8b30972e1306e9fe9db391d4693aa6000917e60)
-  * [Use GenericComponentExtension to refer to wrapped generic comp extensions](https://github.com/LinkedSoftwareDependencies/Components.js/commit/239895accfdb7f09a7ac8454928bd3e0be5e5f15)
-  * [Fix invalid range display with multiple generics](https://github.com/LinkedSoftwareDependencies/Components.js/commit/b98baf0bcf4546b60299ae548f929693345292bc)
-  * [Handle range merging if left or right is union](https://github.com/LinkedSoftwareDependencies/Components.js/commit/637e140106691b95f0f546cf88eb39f3f80dc61d)
-  * [Handle sub-types when merging param ranges](https://github.com/LinkedSoftwareDependencies/Components.js/commit/43290525b2e244f5fbb6d5f344760b863329c31b)
-  * [Allow merging of generic component param types](https://github.com/LinkedSoftwareDependencies/Components.js/commit/ee8de7d9b8d18bf6968a17078e493946e5fca8cd)
-  * [Allow param range merging with generic components](https://github.com/LinkedSoftwareDependencies/Components.js/commit/bcea7dcff288ce7068ee244c49c12134208c89da)
-  * [Fix generics crash when doing repeated param type checking](https://github.com/LinkedSoftwareDependencies/Components.js/commit/237572cb8a9c546b098582041ccd7a457b41aecd)
-
-<a name="v5.0.0-beta.2"></a>
-## [v5.0.0-beta.2](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v5.0.0-beta.1...v5.0.0-beta.2) - 2021-12-09
-
-### Added
-* [Handle keyof parameter ranges](https://github.com/LinkedSoftwareDependencies/Components.js/commit/0f55ba05bff5311d111ca97256aaa2e7be7ae83b)
-
-<a name="v5.0.0-beta.1"></a>
-## [v5.0.0-beta.1](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v5.0.0-beta.0...v5.0.0-beta.1) - 2021-12-07
-
-### Added
-* [Handle generics in nested components](https://github.com/LinkedSoftwareDependencies/Components.js/commit/d33d4c2668974087873943b3d5c66300fa3df65b)
-* [Handle generics in parameter ranges](https://github.com/LinkedSoftwareDependencies/Components.js/commit/d3358b74ab25a3aca13d6dfc97b16cfd836d4ba9)
-* [Add generic vocabulary changes to context](https://github.com/LinkedSoftwareDependencies/Components.js/commit/b8af018bb8f344833c07d1ef795a6b08d414c2ad)
-
-<a name="v5.0.0-beta.0"></a>
-## [v5.0.0-beta.0](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v4.5.0...v5.0.0-beta.0) - 2021-11-30
-
-### BREAKING CHANGES
-* [Remove required and unique param flags in favor of parameter ranges](https://github.com/LinkedSoftwareDependencies/Components.js/commit/0df26318e4803b06660b3458fc75d565c4b60f67):
-  This allows more complex ranges to be defined, such as nested arrays, or arrays of union types.
-  **Because of this change, arrays now must always be explicitly defined within an RDF list (or @list in JSON-LD).**
-  If one param value is provided, it is considered a singular value.
-  If the param value contains an RDF list, it is considered an array.
-  If multiple param values are provided without RDF list, an error is thrown.
-
-### Added
-* Validate parameter values by type:
-  * [Validate param ranges with union and intersection types](https://github.com/LinkedSoftwareDependencies/Components.js/commit/d08ecdb94051d3e88e7e1ea09f0f77518fb0debf)
-  * [Validate types of resource-based param values](https://github.com/LinkedSoftwareDependencies/Components.js/commit/2be90ccb416215261ef9c785e89302f3c4ef9264)
-  * [Validate param ranges with tuple types](https://github.com/LinkedSoftwareDependencies/Components.js/commit/05d84c4c1d4bde6bcb5a99d53df4e66ca69536bf)
-  * [Validate param ranges with literal types](https://github.com/LinkedSoftwareDependencies/Components.js/commit/7373b0fc06bdaf95a8099b9f58b741cd6f4f1b9d)
-
-### Changed
-* [Allow IRIs to be casted to string params](https://github.com/LinkedSoftwareDependencies/Components.js/commit/978985684dcba67629d44bfd0e5cf75293c5ea7a)
-* [Allow components to be registered to multiple modules](https://github.com/LinkedSoftwareDependencies/Components.js/commit/e575e64ebd26092a6bb005d837023e35877e9308)
-* [Make relative IRIs make use of importPaths-based URLs if possible](https://github.com/LinkedSoftwareDependencies/Components.js/commit/6a2e18c3bf6a1b95f826b66ee0ef8b154f10c3cc)
-
-### Fixed
-* [Fix raw JSON values not being serializable to strings](https://github.com/LinkedSoftwareDependencies/Components.js/commit/96fe46eda1e153e87b29689196506ce6fbbdae58)
-
-<a name="v4.5.0"></a>
-## [v4.5.0](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v4.4.1...v4.5.0) - 2021-08-30
-
-### Changed
-* [Migrate to @rdfjs/types](https://github.com/LinkedSoftwareDependencies/Components.js/commit/b2f9f2e0c5512e743b324f48f332d96e4214ec84)
-
-<a name="v4.4.1"></a>
-## [v4.4.1](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v4.4.0...v4.4.1) - 2021-07-26
-
-### Fixed
-* [Fix RDF lists not being accepted for all params](https://github.com/LinkedSoftwareDependencies/Components.js/commit/a01e3c80a3a5ce28180f57e8358327c53774b9ba)
-
-<a name="v4.4.0"></a>
-## [v4.4.0](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v4.2.1...v4.4.0) - 2021-06-30
-
-### Added
-* [Accept RDF lists as argument values, #47](https://github.com/LinkedSoftwareDependencies/Components.js/commit/3501a0fe676d1bc43c2d3ad329fca0adef48c8cd)
-
-### Changed
-* [Allow arrays of resources to be passed to ErrorResourcesContext](https://github.com/LinkedSoftwareDependencies/Components.js/commit/aedd53a3e923e030bf0d8433c27f1259183a0a14)
-
-<a name="v4.3.0"></a>
-## [v4.3.0](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v4.2.1...v4.3.0) - 2021-06-14
-
-### Added
-* [Support JSON param ranges via rdf:JSON, Closes #37](https://github.com/LinkedSoftwareDependencies/Components.js/commit/339d2219915bc618991a42adcd8b63a3d6caa9b5)
-
-<a name="v4.2.1"></a>
-## [v4.2.1](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v4.2.0...v4.2.1) - 2021-05-26
-
-### Fixed
-* [Allow configs to have multiple identical types, comunica/examples#11](https://github.com/LinkedSoftwareDependencies/Components.js/commit/5285f8e68fefb13d46538c6949238200055a2047)
-
-<a name="v4.2.0"></a>
-## [v4.2.0](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v4.1.0...v4.2.0) - 2021-05-19
-
-### Added
-* [Expose RdfObjectLoader ctor from ComponentsManagerBuilder](https://github.com/LinkedSoftwareDependencies/Components.js/commit/1b1c85adb50855eed5b628788ccea3609aa841ca)
-
-<a name="v4.1.0"></a>
-## [v4.1.0](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v4.0.6...v4.1.0) - 2021-04-27
-
-### Added
-* [Allow JSON-LD context validation to be skipped](https://github.com/LinkedSoftwareDependencies/Components.js/commit/40931625dc0a577800c60e0cb4aa12393eb26bab)
-
-<a name="v4.0.6"></a>
-## [v4.0.6](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v4.0.5...v4.0.6) - 2021-01-27
-
-### Fixed
-* [Fix undefined root constructor args missing instead of being undefined](https://github.com/LinkedSoftwareDependencies/Components.js/commit/de14c611122ddb031d2973d4e667efa5b13bdf45)
-
-<a name="v4.0.5"></a>
-## [v4.0.5](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v4.0.4...v4.0.5) - 2021-01-18
-
-### Fixed
-* [Allow module discovery in packages without package.json](https://github.com/LinkedSoftwareDependencies/Components.js/commit/a0ac0cb47b2ed07ef7a88619133af15ba71f3577)
-
-<a name="v4.0.4"></a>
-## [v4.0.4](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v4.0.3...v4.0.4) - 2021-01-15
-
-### Changed
-* [Bump rdf-parse with updated components.js context URL](https://github.com/LinkedSoftwareDependencies/Components.js/commit/7525a027c683890f30f4e47402c89dcca7dd89d7)
-
-<a name="v4.0.3"></a>
-## [v4.0.3](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v4.0.2...v4.0.3) - 2021-01-15
-
-### Fixed
-* [Fix broken infinite recursion workaround, #31](https://github.com/LinkedSoftwareDependencies/Components.js/commit/e9f2fdc78eca77f3070663c4dc360e93b1f4c0bb)
-
-<a name="v4.0.2"></a>
-## [v4.0.2](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v4.0.1...v4.0.2) - 2021-01-15
-
-### Fixed
-* [Fix instances being created multiple times, Closes #31](https://github.com/LinkedSoftwareDependencies/Components.js/commit/94ce08874b24bf9c64d7f722beb2d5556aa9c7e9)
-* [Fix value inheritance happening multiple times](https://github.com/LinkedSoftwareDependencies/Components.js/commit/1855178930d2babd2c3a4c6cdad66087c1db79cd)
-
-<a name="v4.0.1"></a>
-## [v4.0.1](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v4.0.0...v4.0.1) - 2021-01-14
-
-### Fixed
-* [Fix module resolution failure when outside main module](https://github.com/LinkedSoftwareDependencies/Components.js/commit/2fb4de8abda5d5e91d39942edcc0bafd29acd8ce)
-
-<a name="v4.0.0"></a>
-## [v4.0.0](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v3.6.0...v4.0.0) - 2021-01-14
-
-This release contains breaking changes in the programmatic API,
-but module and configuration files remain backwards-compatible.
-
-### Added
-* Developer convenience
-    * [Allow `lsd:module` to be set to true in package.json](https://github.com/LinkedSoftwareDependencies/Components.js/commit/afeac8ab11e801376d265d3e42b5df7e113bfce4)
-    * [Emit warning when a remote context lookup is being done](https://github.com/LinkedSoftwareDependencies/Components.js/commit/0f3968c26ff5c3d38e3cc8282c6039ff1221b4fd)
-    * [Emit warning on potentially invalid parameters in config](https://github.com/LinkedSoftwareDependencies/Components.js/commit/a3ebb95a8d0e18ad062269c47b65cc2d9d1b603a)
-    * [Emit warning on potentially invalid IRIs](https://github.com/LinkedSoftwareDependencies/Components.js/commit/18f9f974965d049fd3808ae3a725a36bf264183b)
-    * [Generate componentsjs-error-state.json on error](https://github.com/LinkedSoftwareDependencies/Components.js/commit/bd47b17ba3fe82b2486e86bc678d950a9c478d18)
-    * [Validate multiple key-value occurences in collectEntries](https://github.com/LinkedSoftwareDependencies/Components.js/commit/ab88b14aa5f2c0c18b34668d6ca1aed8d611de11)
-    * [Improve printing of Resources in error reporting](https://github.com/LinkedSoftwareDependencies/Components.js/commit/48d2df7196a1e80e1bb55ac5c6518394b0942d4d)
-    * [Rewrite injection of custom JSON-LD document loader](https://github.com/LinkedSoftwareDependencies/Components.js/commit/98ae62f9ddb6589a8651f3a4b9bac6b2bb6642b4)
-    * [Migrate RDF loading logic to rdf-object](https://github.com/LinkedSoftwareDependencies/Components.js/commit/e5eb9d27e04a4a333487d5805ce5b0d17cd578a7)
-
-### Changed
-* [Use rdfs:seeAlso instead of owl:imports for importing](https://github.com/LinkedSoftwareDependencies/Components.js/commit/4e4227cca2c588e008259440e211af90e6756949)
-* [Handle semver on multiple occurrences of module packages](https://github.com/LinkedSoftwareDependencies/Components.js/commit/c8b2e3377d397179505064e43c4408e19447df6f)
-* [Improve performance of module state loading through parallelization](https://github.com/LinkedSoftwareDependencies/Components.js/commit/4c475b0ee4d7fae31a818dc72fe28223827fd1f1)
-* Refactoring
-    * [Accept loading from RDF/JS streams, Closes #1](https://github.com/LinkedSoftwareDependencies/Components.js/commit/749a7e7b5166414f68b5aabd285e5fd747b4dac4)
-    * [Add logger](https://github.com/LinkedSoftwareDependencies/Components.js/commit/a5497590d3dabf06c00831f53d95da1554305b10)
-    * [Split up Loader into ComponentsManager and loading classes](https://github.com/LinkedSoftwareDependencies/Components.js/commit/687b15c61ea8766b49dadf132fd38b0151f7f6ac)
-    * [Split parameter property handling into seperate handlers](https://github.com/LinkedSoftwareDependencies/Components.js/commit/e60a2a8bddc8a89b834cc21db51964bb2f8c3a93)
-    * [Create dedicated ParameterHandler component](https://github.com/LinkedSoftwareDependencies/Components.js/commit/408d299f77bc172e61a46d7dfbc4a6c931cecff6)
-    * [Reorganize relevant classes into construction package](https://github.com/LinkedSoftwareDependencies/Components.js/commit/aa6b56328fd4442886a82fcad187bd7380c05f27)
-    * [Split arguments creation into separate handlers](https://github.com/LinkedSoftwareDependencies/Components.js/commit/f3e995bd603369fb6e21d9be041ce96bec3b475b)
-    * [Split constructor args handling into separate handlers](https://github.com/LinkedSoftwareDependencies/Components.js/commit/33f678c5e5df96277243feca893d46882ebdd927)
-    * [Refactor component factories as config preprocessors](https://github.com/LinkedSoftwareDependencies/Components.js/commit/181b165f929cfcab206bc6d5ba22032f76d723c8)
-    * [Remove Util.PREFIXES in favour if Iris](https://github.com/LinkedSoftwareDependencies/Components.js/commit/0c0c671b18bd8fe2161d56fd39ee8645adc12c63)
-    * [Decouple CommonJS instantiation and serialization into strategies](https://github.com/LinkedSoftwareDependencies/Components.js/commit/4756e0ce2f52711d7eb6df7afcc1011da210dbf0)
-    * [Decouple instantiation logic from Loader class](https://github.com/LinkedSoftwareDependencies/Components.js/commit/02dd0e64e37c9961be68beba09f03a3b52d0c00f)
-    * [Rewrite RdfStreamIncluder as Transform stream](https://github.com/LinkedSoftwareDependencies/Components.js/commit/edf6c61b28f06d2539bcdc8498f10586272a2632)
-    * [Delay module registration until finalization phase](https://github.com/LinkedSoftwareDependencies/Components.js/commit/0de3b7940277fd207d7729da4921e62063434e20)
-    * [Refactor module loading into ModuleStateBuilder](https://github.com/LinkedSoftwareDependencies/Components.js/commit/6e6e54b498efb3e922466ef9868995926cd20ca8)
-
-### Removed
-* [Remove feature to use global modules](https://github.com/LinkedSoftwareDependencies/Components.js/commit/fc0f943ac7e1cda4f84b3a65e2ad05ad1c7c42dc)
-
-### Fixed
-* [Fix config compilation using wrong file path](https://github.com/LinkedSoftwareDependencies/Components.js/commit/fd3f806fe9cbb4f74a433e2a31212b5acdddf056)
-* [Fix mapped components only keeping first element of root arrays](https://github.com/LinkedSoftwareDependencies/Components.js/commit/0d33a9d88d473f930ce60c80949d13f5679b0df0)
-
-<a name="v3.6.1"></a>
-## [v3.6.1](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v3.6.0...v3.6.1) - 2020-11-25
-
-### Fixed
-* [Fix Array checks.](https://github.com/LinkedSoftwareDependencies/Components.js/commit/fdd48f6910ce395c72607992056f724953729f32)
-* [Fix function check.](https://github.com/LinkedSoftwareDependencies/Components.js/commit/b685468cfc9de39c74207a1f79cc9efae2bffa4e)
-
-<a name="v3.6.0"></a>
-## [v3.6.0](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v3.5.0...v3.6.0) - 2020-09-14
-
-### Added
-* [Supporting variables in config compilation](https://github.com/LinkedSoftwareDependencies/Components.js/commit/5eb5def9d77b7755d9e121b07c9d23676684a5f1)
-
-<a name="v3.5.0"></a>
-## [v3.5.0](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v3.4.2...v3.5.0) - 2020-09-11
-
-### Added
-* [Accept variables as parameter values, that can be set at init](https://github.com/LinkedSoftwareDependencies/Components.js/commit/cbd6f115cabf2bfcdcc8466f434d5cf52a4c23d5)
-
-<a name="v3.4.2"></a>
-## [v3.4.2](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v3.4.1...v3.4.2) - 2020-08-27
-
-### Fixed
-* [Fix empty list class loading failure](https://github.com/LinkedSoftwareDependencies/Components.js/commit/3590171287d2d765417469ea85012b651c88064b)
-
-<a name="v3.4.1"></a>
-## [v3.4.1](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v3.4.0...v3.4.1) - 2020-07-01
-
-### Changed
-* [Make types proper dependencies](https://github.com/LinkedSoftwareDependencies/Components.js/commit/d50005517d606798de130a6cb2a4a4456683574c)
-
-<a name="v3.4.0"></a>
-## [v3.4.0](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v3.3.0...v3.4.0) - 2020-04-06
-
-### Added
-* [Add requireNoConstructor option for raw requireElements](https://github.com/LinkedSoftwareDependencies/Components.js/commit/2d3144b8baad1464d590b691da10b752f7b83342)
-
-### Fixed
-* [Fix incorrect error message for invalid dynamic entries](https://github.com/LinkedSoftwareDependencies/Components.js/commit/91b3a543973c06e3a0f3b6f667cc04a49e499103)
-
-<a name="v3.3.0"></a>
-## [v3.3.0](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v3.2.1...v3.3.0) - 2019-10-21
-
-### Added
-* [Allow requireName to be a relative path inside the module](https://github.com/LinkedSoftwareDependencies/Components.js/commit/562470dfbe6d3b1ab50e1202d8319adfafda024c)
-
-### Changed
-* [Return error code on failure to compile](https://github.com/LinkedSoftwareDependencies/Components.js/commit/06aa3420911a41963a97586cabbf34ae477084b1)
-
-<a name="v3.2.1"></a>
-## [v3.2.1](https://github.com/LinkedSoftwareDependencies/Components.js/compare/v3.2.0...v3.2.1) - 2019-02-21
-
-### Fixed
-* [Fix issues where context and component files would conflict](https://github.com/LinkedSoftwareDependencies/Components.js/commit/9e4812b23f6bc70099672172d480fc4855775622)
-* [Fix incorrect comment context entry](https://github.com/LinkedSoftwareDependencies/Components.js/commit/21873b34a0dfc366f02ee1ad7dbd580795254ba5)
-
-<a name="v3.2.0"></a>
-## [v3.2.0](https://github.com/LinkedSoftwareDependencies/Components.js/compare/2.0.0...v3.2.0) - 2018-11-13
-
-### Changed
-* [Prioritize main modules when instantiating](https://github.com/LinkedSoftwareDependencies/Components.js/commit/c97f104d101f8dac96b501def69698615f58385b)
-
-<a name="v3.1.0"></a>
-## [v3.1.0](https://github.com/LinkedSoftwareDependencies/Components.js/compare/2.0.0...v3.1.0) - 2018-11-13
-
-_Start tracking of changelog_