componentsjs 4.5.0 → 5.0.0-beta.3

package/CHANGELOG.md

@@ -0,0 +1,261 @@
+# Changelog
+All notable changes to this project will be documented in this file.
+
+<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_

package/README.md

@@ -202,6 +202,22 @@ const myInstance = await manager.instantiate('http://example.org/myInstance');
 [RDF]: https://www.w3.org/RDF/
 [JSON-LD]: https://json-ld.org/
 
+## Cite
+
+If you are using or extending Components.js as part of a scientific publication,
+we would appreciate a citation of our [article](https://linkedsoftwaredependencies.github.io/Article-System-Components/).
+
+```bibtex
+@article{taelman_swj_componentsjs_2022,
+  author = {Taelman, Ruben and Van Herwegen, Joachim and Vander Sande, Miel and Verborgh, Ruben},
+  title = {Components.js: Semantic Dependency Injection},
+  journal = {Semantic Web Journal},
+  year = {2022},
+  month = jan,
+  url = {https://linkedsoftwaredependencies.github.io/Article-System-Components/}
+}
+```
+
 ## License
 Components.js is written by [Ruben Taelman](http://www.rubensworks.net/).
 

package/components/context.jsonld

@@ -2,6 +2,9 @@
   "@context": {
     "rdf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
     "xsd": "http://www.w3.org/2001/XMLSchema#",
+    "type": {
+      "@id": "rdf:type"
+    },
     "types": {
       "@id": "rdf:type"
     },
@@ -22,9 +25,19 @@
     "components": {
       "@id": "oo:component"
     },
+    "component": {
+      "@id": "oo:component",
+      "@type": "@id"
+    },
     "parameters": {
       "@id": "oo:parameter"
     },
+    "memberKeys": {
+      "@id": "oo:memberKey"
+    },
+    "genericTypeParameters": {
+      "@id": "oo:genericTypeParameter"
+    },
     "constructorArguments": {
       "@id": "oo:constructorArguments",
       "@container": "@list"
@@ -61,6 +74,76 @@
     "undefined": {
       "@id": "oo:isUndefined"
     },
+    "ParameterRange": {
+      "@id": "oo:ParameterRange"
+    },
+    "ParameterRangeUndefined": {
+      "@id": "oo:ParameterRangeUndefined"
+    },
+    "ParameterRangeWildcard": {
+      "@id": "oo:ParameterRangeWildcard"
+    },
+    "ParameterRangeArray": {
+      "@id": "oo:ParameterRangeArray"
+    },
+    "ParameterRangeRest": {
+      "@id": "oo:ParameterRangeRest"
+    },
+    "ParameterRangeKeyof": {
+      "@id": "oo:ParameterRangeKeyof"
+    },
+    "ParameterRangeLiteral": {
+      "@id": "oo:ParameterRangeLiteral"
+    },
+    "parameterRangeValue": {
+      "@id": "oo:parameterRangeValue",
+      "@type": "@id"
+    },
+    "parameterRangeValueLiteral": {
+      "@id": "oo:parameterRangeValue"
+    },
+    "ParameterRangeUnion": {
+      "@id": "oo:ParameterRangeUnion"
+    },
+    "ParameterRangeIntersection": {
+      "@id": "oo:ParameterRangeIntersection"
+    },
+    "parameterRangeElements": {
+      "@id": "oo:parameterRangeElements",
+      "@type": "@id"
+    },
+    "ParameterRangeCollectEntries": {
+      "@id": "oo:ParameterRangeCollectEntries"
+    },
+    "parameterRangeCollectEntriesParameters": {
+      "@id": "oo:parameterRangeCollectEntriesParameter",
+      "@type": "@id"
+    },
+    "ParameterRangeGenericComponent": {
+      "@id": "oo:ParameterRangeGenericComponent"
+    },
+    "genericTypeInstancesComponentScope": {
+      "@id": "oo:genericTypeInstancesComponentScope",
+      "@type": "@id"
+    },
+    "genericTypeInstances": {
+      "@id": "oo:genericTypeInstance",
+      "@type": "@id"
+    },
+    "ParameterRangeGenericTypeReference": {
+      "@id": "oo:ParameterRangeGenericTypeReference"
+    },
+    "parameterRangeGenericType": {
+      "@id": "oo:parameterRangeGenericType",
+      "@type": "@id"
+    },
+    "parameterRangeGenericBindings": {
+      "@id": "oo:parameterRangeGenericBindings",
+      "@type": "@id"
+    },
+    "GenericComponentExtension": {
+      "@id": "oo:GenericComponentExtension"
+    },
 
     "rdfs": "http://www.w3.org/2000/01/rdf-schema#",
     "comment": {
@@ -116,7 +199,8 @@
     },
     "fields": {
       "@id": "om:field",
-      "@type": "om:ObjectMapEntry"
+      "@type": "om:ObjectMapEntry",
+      "@container": "@list"
     },
     "elements": {
       "@id": "om:elements",
@@ -125,7 +209,8 @@
     },
     "collectEntries": {
       "@id": "om:collectsEntriesFrom",
-      "@type": "@id"
+      "@type": "@id",
+      "@container": "@list"
     },
     "keyRaw": {
       "@id": "om:fieldName"

package/lib/ComponentsManager.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ComponentsManager = void 0;
 const fs = require("fs");
 const ComponentsManagerBuilder_1 = require("./loading/ComponentsManagerBuilder");
+const ErrorResourcesContext_1 = require("./util/ErrorResourcesContext");
 /**
  * A components manager can instantiate components.
  * This manager should be created using {@link ComponentsManager.build}.
@@ -51,17 +52,14 @@ class ComponentsManager {
      */
     generateErrorLog(error) {
         if (this.dumpErrorState) {
-            const contents = JSON.stringify({
-                componentTypes: Object.keys(this.componentResources),
-                moduleState: {
+            const contents = JSON.stringify(Object.assign(Object.assign({}, error instanceof ErrorResourcesContext_1.ErrorResourcesContext ? error.exportContext() : {}), { componentTypes: Object.keys(this.componentResources), moduleState: {
                     mainModulePath: this.moduleState.mainModulePath,
                     componentModules: this.moduleState.componentModules,
                     importPaths: this.moduleState.importPaths,
                     contexts: this.moduleState.contexts,
                     nodeModuleImportPaths: this.moduleState.nodeModuleImportPaths,
                     nodeModulePaths: this.moduleState.nodeModulePaths,
-                },
-            }, null, '  ');
+                } }), null, '  ');
             fs.writeFileSync('componentsjs-error-state.json', contents, 'utf8');
             this.logger.error(`Detected fatal error. Generated 'componentsjs-error-state.json' with more information.`);
         }

package/lib/construction/ConfigConstructor.js

@@ -31,22 +31,15 @@ class ConfigConstructor {
         this.moduleState = options.moduleState;
     }
     async getArgumentValues(values, settings) {
-        // Unwrap unique values out of the array
-        if (values.length > 0 && values[0].property.unique && values[0].property.unique.value === 'true') {
-            return this.getArgumentValue(values[0], settings);
+        if (values.length === 0) {
+            return this.constructionStrategy.createUndefined();
         }
-        // Unwrap RDF list-based values out of the array
-        if (values.length > 0 && values.some(value => value.list)) {
-            if (values.length > 1) {
-                throw new ErrorResourcesContext_1.ErrorResourcesContext(`Detected multiple values for an argument while only a single RDF list is allowed`, {
-                    arguments: values.flatMap(value => value.list ? value.list : [value]),
-                });
-            }
-            return this.getArgumentValue(values[0], settings);
+        if (values.length > 1) {
+            throw new ErrorResourcesContext_1.ErrorResourcesContext(`Detected multiple values for an argument. RDF lists should be used for defining multiple values.`, {
+                arguments: values,
+            });
         }
-        // Otherwise, keep the array form
-        const elements = await Promise.all(values.map(element => this.getArgumentValue(element, settings)));
-        return this.constructionStrategy.createArray({ settings, elements });
+        return this.getArgumentValue(values[0], settings);
     }
     async getArgumentValue(value, settings) {
         // Check if this args resource can be handled by one of the built-in handlers.

package/lib/construction/argument/ArgumentConstructorHandlerHash.js

@@ -7,11 +7,12 @@ const ErrorResourcesContext_1 = require("../../util/ErrorResourcesContext");
  */
 class ArgumentConstructorHandlerHash {
     canHandle(value, settings, argsCreator) {
-        return Boolean(value.property.fields || value.property.hasFields);
+        return Boolean(value.property.fields);
     }
     async handle(argument, settings, argsCreator) {
+        const fields = argument.property.fields.list || [];
         // Determine all key-value pairs
-        const entries = await Promise.all(argument.properties.fields.map(async (entry) => {
+        const entries = await Promise.all(fields.map(async (entry) => {
             // Validate entry
             if (!entry.property.key) {
                 throw new ErrorResourcesContext_1.ErrorResourcesContext(`Missing key in fields entry`, { entry, argument });

package/lib/construction/strategy/ConstructionStrategyCommonJsString.js

@@ -103,6 +103,9 @@ class ConstructionStrategyCommonJsString {
         return `new function() { return Promise.resolve(${await options.supplier()}); }`;
     }
     createPrimitive(options) {
+        if (typeof options.value === 'object') {
+            return JSON.stringify(options.value);
+        }
         return typeof options.value === 'string' ? `'${options.value}'` : `${options.value}`;
     }
     getVariableValue(options) {

package/lib/construction/strategy/IConstructionStrategy.d.ts

@@ -111,9 +111,9 @@ export interface ICreationStrategyPrimitiveOptions<Instance> {
      */
     settings: IConstructionSettings;
     /**
-     * A string or number value.
+     * A string, number or object value.
      */
-    value: string | number;
+    value: string | number | any;
 }
 export interface ICreationStrategyVariableOptions<Instance> {
     /**

package/lib/loading/ComponentRegistry.js

@@ -55,7 +55,7 @@ class ComponentRegistry {
     registerModuleResource(moduleResource) {
         if (moduleResource.property.components) {
             for (const component of moduleResource.properties.components) {
-                component.property.module = moduleResource;
+                component.properties.module.push(moduleResource);
                 this.registerComponent(component);
             }
         }

package/lib/loading/ComponentRegistryFinalizer.js

@@ -41,7 +41,13 @@ class ComponentRegistryFinalizer {
      * @param superComponents The components to inherit from.
      */
     inheritParameters(component, superComponents) {
-        for (const superComponent of superComponents) {
+        var _a;
+        for (let superComponent of superComponents) {
+            // Check if the super component is wrapped in a generic component instantiation
+            if (((_a = superComponent.property.type) === null || _a === void 0 ? void 0 : _a.value) === this.objectLoader.contextResolved
+                .expandTerm('oo:GenericComponentExtension')) {
+                superComponent = superComponent.property.component;
+            }
             this.componentRegistry.requireValidComponent(superComponent, component);
             for (const parameter of superComponent.properties.parameters) {
                 if (!component.properties.parameters.includes(parameter)) {
@@ -75,11 +81,26 @@ class ComponentRegistryFinalizer {
      * @param extendingConstructorArgs The constructor argument resources to inherit from.
      */
     inheritConstructorArgumentsEntry(constructorArg, extendingConstructorArgs) {
+        // Make sure that we have fields in list-form
+        if (constructorArg.property.fields && !constructorArg.property.fields.list) {
+            if (constructorArg.properties.fields.length > 1) {
+                throw new ErrorResourcesContext_1.ErrorResourcesContext(`Invalid fields: Only one value can be defined, or an RDF list must be provided`, {
+                    constructorArg,
+                });
+            }
+            constructorArg.property.fields = this.objectLoader.createCompactedResource({
+                list: constructorArg.properties.fields,
+            });
+        }
         for (const extendingConstructorArg of extendingConstructorArgs) {
             if (extendingConstructorArg.property.fields) {
-                for (const field of extendingConstructorArg.properties.fields) {
-                    if (!constructorArg.properties.fields.includes(field)) {
-                        constructorArg.properties.fields.push(field);
+                // Inherit fields
+                for (const field of extendingConstructorArg.property.fields.list || extendingConstructorArg.properties.fields) {
+                    if (!constructorArg.property.fields) {
+                        constructorArg.property.fields = this.objectLoader.createCompactedResource({ list: [] });
+                    }
+                    if (!constructorArg.property.fields.list.includes(field)) {
+                        constructorArg.property.fields.list.push(field);
                     }
                 }
             }

package/lib/preprocess/ConfigPreprocessorComponent.d.ts

@@ -1,5 +1,6 @@
 import type { Resource, RdfObjectLoader } from 'rdf-object';
 import type { Logger } from 'winston';
+import { GenericsContext } from './GenericsContext';
 import type { IConfigPreprocessor } from './IConfigPreprocessor';
 import type { ParameterHandler } from './ParameterHandler';
 /**
@@ -15,12 +16,13 @@ export declare class ConfigPreprocessorComponent implements IConfigPreprocessor<
     constructor(options: IComponentConfigPreprocessorOptions);
     canHandle(config: Resource): IComponentConfigPreprocessorHandleResponse | undefined;
     transform(config: Resource, handleResponse: IComponentConfigPreprocessorHandleResponse): Resource;
+    protected createGenericsContext(handleResponse: IComponentConfigPreprocessorHandleResponse, config: Resource): GenericsContext;
     /**
      * Determine the constructor arguments of the given config.
      * @param config A config.
      * @param handleResponse Return value of the {#canHandle}.
      */
-    transformConstructorArguments(config: Resource, handleResponse: IComponentConfigPreprocessorHandleResponse): Resource[];
+    transformConstructorArguments(config: Resource, handleResponse: IComponentConfigPreprocessorHandleResponse): Resource;
     /**
      * Let this config inherit parameter values from previously instantiated configs.
      * This will check for inheritanceValues that are defined on the component,