@twin.org/data-json-ld 0.0.1-next.3 → 0.0.1-next.5

package/dist/cjs/index.cjs

@@ -374,33 +374,7 @@ var anyOf$7 = [
 		type: "object",
 		properties: {
 			"@context": {
-				anyOf: [
-					{
-						type: "null"
-					},
-					{
-						type: "string"
-					},
-					{
-						$ref: "https://schema.twindev.org/json-ld/JsonLdContextDefinition"
-					},
-					{
-						type: "array",
-						items: {
-							anyOf: [
-								{
-									type: "null"
-								},
-								{
-									type: "string"
-								},
-								{
-									$ref: "https://schema.twindev.org/json-ld/JsonLdContextDefinition"
-								}
-							]
-						}
-					}
-				]
+				$ref: "https://schema.twindev.org/json-ld/JsonLdContextDefinitionRoot"
 			},
 			"@graph": {
 				anyOf: [
@@ -562,33 +536,7 @@ var properties$4 = {
 		]
 	},
 	"@context": {
-		anyOf: [
-			{
-				type: "null"
-			},
-			{
-				type: "string"
-			},
-			{
-				$ref: "https://schema.twindev.org/json-ld/JsonLdContextDefinition"
-			},
-			{
-				type: "array",
-				items: {
-					anyOf: [
-						{
-							type: "null"
-						},
-						{
-							type: "string"
-						},
-						{
-							$ref: "https://schema.twindev.org/json-ld/JsonLdContextDefinition"
-						}
-					]
-				}
-			}
-		]
+		$ref: "https://schema.twindev.org/json-ld/JsonLdContextDefinitionRoot"
 	}
 };
 var required$3 = [
@@ -784,33 +732,7 @@ var properties$3 = {
 		]
 	},
 	"@context": {
-		anyOf: [
-			{
-				type: "null"
-			},
-			{
-				type: "string"
-			},
-			{
-				$ref: "https://schema.twindev.org/json-ld/JsonLdContextDefinition"
-			},
-			{
-				type: "array",
-				items: {
-					anyOf: [
-						{
-							type: "null"
-						},
-						{
-							type: "string"
-						},
-						{
-							$ref: "https://schema.twindev.org/json-ld/JsonLdContextDefinition"
-						}
-					]
-				}
-			}
-		]
+		$ref: "https://schema.twindev.org/json-ld/JsonLdContextDefinitionRoot"
 	},
 	"@direction": {
 		type: [
@@ -1062,33 +984,7 @@ var JsonLdListOrSetItemSchema = {
 var type$2 = "object";
 var properties$1 = {
 	"@context": {
-		anyOf: [
-			{
-				type: "null"
-			},
-			{
-				type: "string"
-			},
-			{
-				$ref: "https://schema.twindev.org/json-ld/JsonLdContextDefinition"
-			},
-			{
-				type: "array",
-				items: {
-					anyOf: [
-						{
-							type: "null"
-						},
-						{
-							type: "string"
-						},
-						{
-							$ref: "https://schema.twindev.org/json-ld/JsonLdContextDefinition"
-						}
-					]
-				}
-			}
-		]
+		$ref: "https://schema.twindev.org/json-ld/JsonLdContextDefinitionRoot"
 	},
 	"@id": {
 		anyOf: [
@@ -1531,16 +1427,39 @@ class JsonLdProcessor {
     /**
      * Compact a document according to a particular context.
      * @param document The JSON-LD document to compact.
-     * @param context The context to compact the document to.
+     * @param context The context to compact the document to, if not provided will try and gather from the object.
      * @returns The compacted JSON-LD document.
      */
     static async compact(document, context) {
         try {
-            return jsonLd.compact(document, context ?? {}, {
+            // There is a cast here because the jsonld types are not correct.
+            // A context definition can be an array or an object, but the types only allow an object.
+            if (core.Is.empty(context)) {
+                context = {};
+                if (core.Is.array(document)) {
+                    for (const node of document) {
+                        context = JsonLdProcessor.gatherContexts(node, context);
+                    }
+                }
+                else if (core.Is.array(document["@graph"])) {
+                    for (const node of document["@graph"]) {
+                        context = JsonLdProcessor.gatherContexts(node, context);
+                    }
+                }
+                else if (core.Is.object(document)) {
+                    context = JsonLdProcessor.gatherContexts(document, context);
+                }
+            }
+            const compacted = await jsonLd.compact(document, context, {
                 documentLoader: JsonLdProcessor.DOCUMENT_LOADER
             });
+            return compacted;
         }
         catch (err) {
+            if (core.Is.object(err) &&
+                err.name === "jsonld.InvalidUrl") {
+                throw new core.GeneralError(JsonLdProcessor._CLASS_NAME, "invalidUrl", { url: err.details?.url }, err);
+            }
             throw new core.GeneralError(JsonLdProcessor._CLASS_NAME, "compact", undefined, err);
         }
     }
@@ -1551,11 +1470,16 @@ class JsonLdProcessor {
      */
     static async expand(compacted) {
         try {
-            return jsonLd.expand(compacted, {
+            const expanded = await jsonLd.expand(compacted, {
                 documentLoader: JsonLdProcessor.DOCUMENT_LOADER
             });
+            return expanded;
         }
         catch (err) {
+            if (core.Is.object(err) &&
+                err.name === "jsonld.InvalidUrl") {
+                throw new core.GeneralError(JsonLdProcessor._CLASS_NAME, "invalidUrl", { url: err.details?.url }, err);
+            }
             throw new core.GeneralError(JsonLdProcessor._CLASS_NAME, "expand", undefined, err);
         }
     }
@@ -1569,6 +1493,103 @@ class JsonLdProcessor {
             this._redirects.push({ from, to });
         }
     }
+    /**
+     * Extract a property from the JSON-LD.
+     * @param nodeObject The JSON-LD node object to extract from.
+     * @param propertyNames The possible names for the property.
+     * @param deleteProperty Delete the property from the object, defaults to true.
+     * @returns The properties if available.
+     */
+    static extractProperty(nodeObject, propertyNames, deleteProperty = true) {
+        let retVal;
+        for (const prop of propertyNames) {
+            retVal ??= nodeObject[prop];
+            if (deleteProperty) {
+                delete nodeObject[prop];
+            }
+        }
+        return retVal;
+    }
+    /**
+     * Combine contexts.
+     * @param context1 The first JSON-LD context to combine.
+     * @param context2 The second JSON-LD context to combine.
+     * @returns The combined context.
+     */
+    static combineContexts(context1, context2) {
+        const combinedContext = [];
+        if (core.Is.string(context1)) {
+            if (!combinedContext.includes(context1)) {
+                combinedContext.push(context1);
+            }
+        }
+        else if (core.Is.array(context1)) {
+            for (const context of context1) {
+                const hasMatch = combinedContext.some(c => core.ObjectHelper.equal(c, context));
+                if (!hasMatch) {
+                    combinedContext.push(context);
+                }
+            }
+        }
+        else if (core.Is.object(context1)) {
+            const hasMatch = combinedContext.some(c => core.ObjectHelper.equal(c, context1));
+            if (!hasMatch) {
+                combinedContext.push(context1);
+            }
+        }
+        if (core.Is.string(context2)) {
+            if (!combinedContext.includes(context2)) {
+                combinedContext.push(context2);
+            }
+        }
+        else if (core.Is.array(context2)) {
+            for (const context of context2) {
+                const hasMatch = combinedContext.some(c => core.ObjectHelper.equal(c, context));
+                if (!hasMatch) {
+                    combinedContext.push(context);
+                }
+            }
+        }
+        else if (core.Is.object(context2)) {
+            const hasMatch = combinedContext.some(c => core.ObjectHelper.equal(c, context2));
+            if (!hasMatch) {
+                combinedContext.push(context2);
+            }
+        }
+        if (combinedContext.length === 0) {
+            return null;
+        }
+        if (combinedContext.length === 1) {
+            return combinedContext[0];
+        }
+        return combinedContext;
+    }
+    /**
+     * Gather all the contexts from the element and it's children.
+     * @param element The element to gather the contexts from.
+     * @param initial The initial context.
+     * @returns The combined contexts.
+     */
+    static gatherContexts(element, initial) {
+        let combinedContexts = initial;
+        if (!core.Is.empty(element["@context"])) {
+            combinedContexts = JsonLdProcessor.combineContexts(initial, element["@context"]);
+        }
+        for (const prop of Object.keys(element)) {
+            const value = element[prop];
+            if (core.Is.object(value)) {
+                combinedContexts = this.gatherContexts(value, combinedContexts);
+            }
+            else if (core.Is.array(value)) {
+                for (const item of value) {
+                    if (core.Is.object(item)) {
+                        combinedContexts = this.gatherContexts(item, combinedContexts);
+                    }
+                }
+            }
+        }
+        return combinedContexts;
+    }
     /**
      * Document loader which uses a caching mechanism.
      * @param url The document url to load.

package/dist/esm/index.mjs

@@ -1,5 +1,5 @@
 import { DataTypeHandlerFactory, DataTypeHelper } from '@twin.org/data-core';
-import { Is, GeneralError } from '@twin.org/core';
+import { Is, GeneralError, ObjectHelper } from '@twin.org/core';
 import { FetchHelper, HttpMethod, MimeTypes } from '@twin.org/web';
 import jsonLd from 'jsonld';
 
@@ -372,33 +372,7 @@ var anyOf$7 = [
 		type: "object",
 		properties: {
 			"@context": {
-				anyOf: [
-					{
-						type: "null"
-					},
-					{
-						type: "string"
-					},
-					{
-						$ref: "https://schema.twindev.org/json-ld/JsonLdContextDefinition"
-					},
-					{
-						type: "array",
-						items: {
-							anyOf: [
-								{
-									type: "null"
-								},
-								{
-									type: "string"
-								},
-								{
-									$ref: "https://schema.twindev.org/json-ld/JsonLdContextDefinition"
-								}
-							]
-						}
-					}
-				]
+				$ref: "https://schema.twindev.org/json-ld/JsonLdContextDefinitionRoot"
 			},
 			"@graph": {
 				anyOf: [
@@ -560,33 +534,7 @@ var properties$4 = {
 		]
 	},
 	"@context": {
-		anyOf: [
-			{
-				type: "null"
-			},
-			{
-				type: "string"
-			},
-			{
-				$ref: "https://schema.twindev.org/json-ld/JsonLdContextDefinition"
-			},
-			{
-				type: "array",
-				items: {
-					anyOf: [
-						{
-							type: "null"
-						},
-						{
-							type: "string"
-						},
-						{
-							$ref: "https://schema.twindev.org/json-ld/JsonLdContextDefinition"
-						}
-					]
-				}
-			}
-		]
+		$ref: "https://schema.twindev.org/json-ld/JsonLdContextDefinitionRoot"
 	}
 };
 var required$3 = [
@@ -782,33 +730,7 @@ var properties$3 = {
 		]
 	},
 	"@context": {
-		anyOf: [
-			{
-				type: "null"
-			},
-			{
-				type: "string"
-			},
-			{
-				$ref: "https://schema.twindev.org/json-ld/JsonLdContextDefinition"
-			},
-			{
-				type: "array",
-				items: {
-					anyOf: [
-						{
-							type: "null"
-						},
-						{
-							type: "string"
-						},
-						{
-							$ref: "https://schema.twindev.org/json-ld/JsonLdContextDefinition"
-						}
-					]
-				}
-			}
-		]
+		$ref: "https://schema.twindev.org/json-ld/JsonLdContextDefinitionRoot"
 	},
 	"@direction": {
 		type: [
@@ -1060,33 +982,7 @@ var JsonLdListOrSetItemSchema = {
 var type$2 = "object";
 var properties$1 = {
 	"@context": {
-		anyOf: [
-			{
-				type: "null"
-			},
-			{
-				type: "string"
-			},
-			{
-				$ref: "https://schema.twindev.org/json-ld/JsonLdContextDefinition"
-			},
-			{
-				type: "array",
-				items: {
-					anyOf: [
-						{
-							type: "null"
-						},
-						{
-							type: "string"
-						},
-						{
-							$ref: "https://schema.twindev.org/json-ld/JsonLdContextDefinition"
-						}
-					]
-				}
-			}
-		]
+		$ref: "https://schema.twindev.org/json-ld/JsonLdContextDefinitionRoot"
 	},
 	"@id": {
 		anyOf: [
@@ -1529,16 +1425,39 @@ class JsonLdProcessor {
     /**
      * Compact a document according to a particular context.
      * @param document The JSON-LD document to compact.
-     * @param context The context to compact the document to.
+     * @param context The context to compact the document to, if not provided will try and gather from the object.
      * @returns The compacted JSON-LD document.
      */
     static async compact(document, context) {
         try {
-            return jsonLd.compact(document, context ?? {}, {
+            // There is a cast here because the jsonld types are not correct.
+            // A context definition can be an array or an object, but the types only allow an object.
+            if (Is.empty(context)) {
+                context = {};
+                if (Is.array(document)) {
+                    for (const node of document) {
+                        context = JsonLdProcessor.gatherContexts(node, context);
+                    }
+                }
+                else if (Is.array(document["@graph"])) {
+                    for (const node of document["@graph"]) {
+                        context = JsonLdProcessor.gatherContexts(node, context);
+                    }
+                }
+                else if (Is.object(document)) {
+                    context = JsonLdProcessor.gatherContexts(document, context);
+                }
+            }
+            const compacted = await jsonLd.compact(document, context, {
                 documentLoader: JsonLdProcessor.DOCUMENT_LOADER
             });
+            return compacted;
         }
         catch (err) {
+            if (Is.object(err) &&
+                err.name === "jsonld.InvalidUrl") {
+                throw new GeneralError(JsonLdProcessor._CLASS_NAME, "invalidUrl", { url: err.details?.url }, err);
+            }
             throw new GeneralError(JsonLdProcessor._CLASS_NAME, "compact", undefined, err);
         }
     }
@@ -1549,11 +1468,16 @@ class JsonLdProcessor {
      */
     static async expand(compacted) {
         try {
-            return jsonLd.expand(compacted, {
+            const expanded = await jsonLd.expand(compacted, {
                 documentLoader: JsonLdProcessor.DOCUMENT_LOADER
             });
+            return expanded;
         }
         catch (err) {
+            if (Is.object(err) &&
+                err.name === "jsonld.InvalidUrl") {
+                throw new GeneralError(JsonLdProcessor._CLASS_NAME, "invalidUrl", { url: err.details?.url }, err);
+            }
             throw new GeneralError(JsonLdProcessor._CLASS_NAME, "expand", undefined, err);
         }
     }
@@ -1567,6 +1491,103 @@ class JsonLdProcessor {
             this._redirects.push({ from, to });
         }
     }
+    /**
+     * Extract a property from the JSON-LD.
+     * @param nodeObject The JSON-LD node object to extract from.
+     * @param propertyNames The possible names for the property.
+     * @param deleteProperty Delete the property from the object, defaults to true.
+     * @returns The properties if available.
+     */
+    static extractProperty(nodeObject, propertyNames, deleteProperty = true) {
+        let retVal;
+        for (const prop of propertyNames) {
+            retVal ??= nodeObject[prop];
+            if (deleteProperty) {
+                delete nodeObject[prop];
+            }
+        }
+        return retVal;
+    }
+    /**
+     * Combine contexts.
+     * @param context1 The first JSON-LD context to combine.
+     * @param context2 The second JSON-LD context to combine.
+     * @returns The combined context.
+     */
+    static combineContexts(context1, context2) {
+        const combinedContext = [];
+        if (Is.string(context1)) {
+            if (!combinedContext.includes(context1)) {
+                combinedContext.push(context1);
+            }
+        }
+        else if (Is.array(context1)) {
+            for (const context of context1) {
+                const hasMatch = combinedContext.some(c => ObjectHelper.equal(c, context));
+                if (!hasMatch) {
+                    combinedContext.push(context);
+                }
+            }
+        }
+        else if (Is.object(context1)) {
+            const hasMatch = combinedContext.some(c => ObjectHelper.equal(c, context1));
+            if (!hasMatch) {
+                combinedContext.push(context1);
+            }
+        }
+        if (Is.string(context2)) {
+            if (!combinedContext.includes(context2)) {
+                combinedContext.push(context2);
+            }
+        }
+        else if (Is.array(context2)) {
+            for (const context of context2) {
+                const hasMatch = combinedContext.some(c => ObjectHelper.equal(c, context));
+                if (!hasMatch) {
+                    combinedContext.push(context);
+                }
+            }
+        }
+        else if (Is.object(context2)) {
+            const hasMatch = combinedContext.some(c => ObjectHelper.equal(c, context2));
+            if (!hasMatch) {
+                combinedContext.push(context2);
+            }
+        }
+        if (combinedContext.length === 0) {
+            return null;
+        }
+        if (combinedContext.length === 1) {
+            return combinedContext[0];
+        }
+        return combinedContext;
+    }
+    /**
+     * Gather all the contexts from the element and it's children.
+     * @param element The element to gather the contexts from.
+     * @param initial The initial context.
+     * @returns The combined contexts.
+     */
+    static gatherContexts(element, initial) {
+        let combinedContexts = initial;
+        if (!Is.empty(element["@context"])) {
+            combinedContexts = JsonLdProcessor.combineContexts(initial, element["@context"]);
+        }
+        for (const prop of Object.keys(element)) {
+            const value = element[prop];
+            if (Is.object(value)) {
+                combinedContexts = this.gatherContexts(value, combinedContexts);
+            }
+            else if (Is.array(value)) {
+                for (const item of value) {
+                    if (Is.object(item)) {
+                        combinedContexts = this.gatherContexts(item, combinedContexts);
+                    }
+                }
+            }
+        }
+        return combinedContexts;
+    }
     /**
      * Document loader which uses a caching mechanism.
      * @param url The document url to load.

package/dist/types/models/IJsonLdDocument.d.ts

@@ -140,6 +140,14 @@ export interface IJsonLdContextDefinition {
     "@version"?: IJsonLdKeyword["@version"] | undefined;
     "@vocab"?: IJsonLdKeyword["@vocab"] | undefined;
 }
+/**
+ * A context definition element is used to define the types of a context definition.
+ */
+export type IJsonLdContextDefinitionElement = null | string | IJsonLdContextDefinition;
+/**
+ * A context definition root is used to define the root of a context definition.
+ */
+export type IJsonLdContextDefinitionRoot = IJsonLdContextDefinitionElement | IJsonLdContextDefinitionElement[];
 /**
  * An expanded term definition is used to describe the mapping between a term
  * and its expanded identifier, as well as other properties of the value
@@ -171,7 +179,7 @@ export type IJsonLdExpandedTermDefinition = {
 export type IJsonLdKeyword = {
     "@base": string | null;
     "@container": ("@list" | "@set" | IJsonLdContainerType) | ("@list" | "@set" | IJsonLdContainerType)[] | IJsonLdContainerTypeArray | null;
-    "@context": null | string | IJsonLdContextDefinition | (null | string | IJsonLdContextDefinition)[];
+    "@context": IJsonLdContextDefinitionRoot;
     "@direction": "ltr" | "rtl" | null;
     "@graph": IJsonLdValueObject | IJsonLdNodeObject | (IJsonLdValueObject | IJsonLdNodeObject)[];
     "@id": string | string[];

package/dist/types/utils/jsonLdProcessor.d.ts

@@ -1,5 +1,5 @@
 import type { RemoteDocument, Url } from "jsonld/jsonld-spec";
-import type { IJsonLdContextDefinition, IJsonLdDocument } from "../models/IJsonLdDocument";
+import type { IJsonLdContextDefinitionRoot, IJsonLdDocument, IJsonLdNodeObject } from "../models/IJsonLdDocument";
 /**
  * JSON-LD Processor.
  */
@@ -15,10 +15,10 @@ export declare class JsonLdProcessor {
     /**
      * Compact a document according to a particular context.
      * @param document The JSON-LD document to compact.
-     * @param context The context to compact the document to.
+     * @param context The context to compact the document to, if not provided will try and gather from the object.
      * @returns The compacted JSON-LD document.
      */
-    static compact(document: IJsonLdDocument, context?: IJsonLdContextDefinition): Promise<IJsonLdDocument>;
+    static compact(document: IJsonLdDocument, context?: IJsonLdContextDefinitionRoot): Promise<IJsonLdDocument>;
     /**
      * Expand a document, removing its context.
      * @param compacted The compacted JSON-LD document to expand.
@@ -31,4 +31,28 @@ export declare class JsonLdProcessor {
      * @param to The URL to redirect to.
      */
     static addRedirect(from: RegExp, to: string): void;
+    /**
+     * Extract a property from the JSON-LD.
+     * @param nodeObject The JSON-LD node object to extract from.
+     * @param propertyNames The possible names for the property.
+     * @param deleteProperty Delete the property from the object, defaults to true.
+     * @returns The properties if available.
+     */
+    static extractProperty<T>(nodeObject: IJsonLdNodeObject, propertyNames: string[], deleteProperty?: boolean): T | undefined;
+    /**
+     * Combine contexts.
+     * @param context1 The first JSON-LD context to combine.
+     * @param context2 The second JSON-LD context to combine.
+     * @returns The combined context.
+     */
+    static combineContexts(context1: IJsonLdContextDefinitionRoot | undefined, context2: IJsonLdContextDefinitionRoot | undefined): IJsonLdContextDefinitionRoot | undefined;
+    /**
+     * Gather all the contexts from the element and it's children.
+     * @param element The element to gather the contexts from.
+     * @param initial The initial context.
+     * @returns The combined contexts.
+     */
+    static gatherContexts(element: {
+        [id: string]: unknown;
+    }, initial?: IJsonLdContextDefinitionRoot): IJsonLdContextDefinitionRoot | undefined;
 }

package/docs/changelog.md

@@ -1,5 +1,5 @@
 # @twin.org/data-json-ld - Changelog
 
-## v0.0.1-next.3
+## v0.0.1-next.5
 
 - Initial Release

package/docs/reference/classes/JsonLdProcessor.md

@@ -42,9 +42,9 @@ Compact a document according to a particular context.
 
 The JSON-LD document to compact.
 
-• **context?**: [`IJsonLdContextDefinition`](../interfaces/IJsonLdContextDefinition.md)
+• **context?**: [`IJsonLdContextDefinitionRoot`](../type-aliases/IJsonLdContextDefinitionRoot.md)
 
-The context to compact the document to.
+The context to compact the document to, if not provided will try and gather from the object.
 
 #### Returns
 
@@ -93,3 +93,83 @@ The URL to redirect to.
 #### Returns
 
 `void`
+
+***
+
+### extractProperty()
+
+> `static` **extractProperty**\<`T`\>(`nodeObject`, `propertyNames`, `deleteProperty`): `undefined` \| `T`
+
+Extract a property from the JSON-LD.
+
+#### Type Parameters
+
+• **T**
+
+#### Parameters
+
+• **nodeObject**: [`IJsonLdNodeObject`](../interfaces/IJsonLdNodeObject.md)
+
+The JSON-LD node object to extract from.
+
+• **propertyNames**: `string`[]
+
+The possible names for the property.
+
+• **deleteProperty**: `boolean` = `true`
+
+Delete the property from the object, defaults to true.
+
+#### Returns
+
+`undefined` \| `T`
+
+The properties if available.
+
+***
+
+### combineContexts()
+
+> `static` **combineContexts**(`context1`, `context2`): `undefined` \| [`IJsonLdContextDefinitionRoot`](../type-aliases/IJsonLdContextDefinitionRoot.md)
+
+Combine contexts.
+
+#### Parameters
+
+• **context1**: `undefined` \| [`IJsonLdContextDefinitionRoot`](../type-aliases/IJsonLdContextDefinitionRoot.md)
+
+The first JSON-LD context to combine.
+
+• **context2**: `undefined` \| [`IJsonLdContextDefinitionRoot`](../type-aliases/IJsonLdContextDefinitionRoot.md)
+
+The second JSON-LD context to combine.
+
+#### Returns
+
+`undefined` \| [`IJsonLdContextDefinitionRoot`](../type-aliases/IJsonLdContextDefinitionRoot.md)
+
+The combined context.
+
+***
+
+### gatherContexts()
+
+> `static` **gatherContexts**(`element`, `initial`?): `undefined` \| [`IJsonLdContextDefinitionRoot`](../type-aliases/IJsonLdContextDefinitionRoot.md)
+
+Gather all the contexts from the element and it's children.
+
+#### Parameters
+
+• **element**
+
+The element to gather the contexts from.
+
+• **initial?**: [`IJsonLdContextDefinitionRoot`](../type-aliases/IJsonLdContextDefinitionRoot.md)
+
+The initial context.
+
+#### Returns
+
+`undefined` \| [`IJsonLdContextDefinitionRoot`](../type-aliases/IJsonLdContextDefinitionRoot.md)
+
+The combined contexts.

package/docs/reference/index.md

@@ -26,6 +26,8 @@
 - [IJsonLdValueObject](type-aliases/IJsonLdValueObject.md)
 - [IJsonLdIndexMapItem](type-aliases/IJsonLdIndexMapItem.md)
 - [IJsonLdIncludedBlock](type-aliases/IJsonLdIncludedBlock.md)
+- [IJsonLdContextDefinitionElement](type-aliases/IJsonLdContextDefinitionElement.md)
+- [IJsonLdContextDefinitionRoot](type-aliases/IJsonLdContextDefinitionRoot.md)
 - [IJsonLdExpandedTermDefinition](type-aliases/IJsonLdExpandedTermDefinition.md)
 - [IJsonLdKeyword](type-aliases/IJsonLdKeyword.md)
 - [IJsonLdListOrSetItem](type-aliases/IJsonLdListOrSetItem.md)

package/docs/reference/interfaces/IJsonLdGraphObject.md

@@ -28,4 +28,4 @@ https://www.w3.org/TR/json-ld11/#graph-objects
 
 ### @context?
 
-> `optional` **@context**: `null` \| `string` \| [`IJsonLdContextDefinition`](IJsonLdContextDefinition.md) \| (`null` \| `string` \| [`IJsonLdContextDefinition`](IJsonLdContextDefinition.md))[]
+> `optional` **@context**: [`IJsonLdContextDefinitionRoot`](../type-aliases/IJsonLdContextDefinitionRoot.md)

package/docs/reference/interfaces/IJsonLdNodeObject.md

@@ -15,7 +15,7 @@ https://www.w3.org/TR/json-ld11/#node-objects
 
 ### @context?
 
-> `optional` **@context**: `null` \| `string` \| [`IJsonLdContextDefinition`](IJsonLdContextDefinition.md) \| (`null` \| `string` \| [`IJsonLdContextDefinition`](IJsonLdContextDefinition.md))[]
+> `optional` **@context**: [`IJsonLdContextDefinitionRoot`](../type-aliases/IJsonLdContextDefinitionRoot.md)
 
 ***
 

package/docs/reference/type-aliases/IJsonLdContextDefinitionElement.md

@@ -0,0 +1,5 @@
+# Type Alias: IJsonLdContextDefinitionElement
+
+> **IJsonLdContextDefinitionElement**: `null` \| `string` \| [`IJsonLdContextDefinition`](../interfaces/IJsonLdContextDefinition.md)
+
+A context definition element is used to define the types of a context definition.

package/docs/reference/type-aliases/IJsonLdContextDefinitionRoot.md

@@ -0,0 +1,5 @@
+# Type Alias: IJsonLdContextDefinitionRoot
+
+> **IJsonLdContextDefinitionRoot**: [`IJsonLdContextDefinitionElement`](IJsonLdContextDefinitionElement.md) \| [`IJsonLdContextDefinitionElement`](IJsonLdContextDefinitionElement.md)[]
+
+A context definition root is used to define the root of a context definition.

package/docs/reference/type-aliases/IJsonLdKeyword.md

@@ -18,7 +18,7 @@ Not for export.
 
 ### @context
 
-> **@context**: `null` \| `string` \| [`IJsonLdContextDefinition`](../interfaces/IJsonLdContextDefinition.md) \| (`null` \| `string` \| [`IJsonLdContextDefinition`](../interfaces/IJsonLdContextDefinition.md))[]
+> **@context**: [`IJsonLdContextDefinitionRoot`](IJsonLdContextDefinitionRoot.md)
 
 ### @direction
 

package/locales/en.json

@@ -1,6 +1,7 @@
 {
-	"jsonLdHelper": {
+	"jsonLdProcessor": {
 		"compact": "The JSON-LD compaction failed",
-		"expand": "The JSON-LD expansion failed"
+		"expand": "The JSON-LD expansion failed",
+		"invalidUrl": "The JSON-LD processing failed to retrieve from the following url \"{url}\""
 	}
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@twin.org/data-json-ld",
-	"version": "0.0.1-next.3",
+	"version": "0.0.1-next.5",
 	"description": "Models which define the structure of JSON LD",
 	"repository": {
 		"type": "git",
@@ -13,46 +13,16 @@
 	"engines": {
 		"node": ">=20.0.0"
 	},
-	"scripts": {
-		"clean": "rimraf dist coverage docs/reference src/schemas",
-		"build:schema": "ts-to-schema ./ts-to-schema.json ./src/schemas",
-		"build:compile": "tspc",
-		"build": "npm run build:schema && npm run build:compile",
-		"test": "vitest --run --config ./vitest.config.ts --no-cache",
-		"coverage": "vitest --run --coverage --config ./vitest.config.ts --no-cache",
-		"bundle:esm": "rollup --config rollup.config.mjs --environment MODULE:esm",
-		"bundle:cjs": "rollup --config rollup.config.mjs --environment MODULE:cjs",
-		"bundle": "npm run bundle:esm && npm run bundle:cjs",
-		"docs:clean": "rimraf docs/reference",
-		"docs:generate": "typedoc",
-		"docs": "npm run docs:clean && npm run docs:generate",
-		"dist": "npm run clean && npm run build && npm run test && npm run bundle && npm run docs"
-	},
 	"dependencies": {
 		"@twin.org/core": "next",
-		"@twin.org/data-core": "0.0.1-next.3",
+		"@twin.org/data-core": "0.0.1-next.5",
 		"@twin.org/entity": "next",
 		"@twin.org/nameof": "next",
 		"@twin.org/web": "next",
-		"@types/jsonld": "1.5.15",
 		"@types/json-schema": "7.0.15",
+		"@types/jsonld": "1.5.15",
 		"jsonld": "8.3.2"
 	},
-	"devDependencies": {
-		"@twin.org/nameof-transformer": "next",
-		"@twin.org/ts-to-schema": "next",
-		"@rollup/plugin-json": "6.1.0",
-		"@vitest/coverage-v8": "2.1.1",
-		"copyfiles": "2.4.1",
-		"rimraf": "6.0.1",
-		"rollup": "4.22.0",
-		"rollup-plugin-typescript2": "0.36.0",
-		"ts-patch": "3.2.1",
-		"typedoc": "0.26.7",
-		"typedoc-plugin-markdown": "4.2.7",
-		"typescript": "5.6.2",
-		"vitest": "2.1.1"
-	},
 	"main": "./dist/cjs/index.cjs",
 	"module": "./dist/esm/index.mjs",
 	"types": "./dist/types/index.d.ts",