@fedify/vocab-runtime 2.4.0-dev.1570 → 2.4.0-dev.1571

package/deno.json

@@ -1,9 +1,10 @@
 {
   "name": "@fedify/vocab-runtime",
-  "version": "2.4.0-dev.1570+f1b6aaa3",
+  "version": "2.4.0-dev.1571+31e2786b",
   "license": "MIT",
   "exports": {
     ".": "./src/mod.ts",
+    "./internal/jsonld-cache": "./src/internal/jsonld-cache.ts",
     "./jsonld": "./src/jsonld.ts",
     "./temporal": "./src/temporal.ts"
   },

package/dist/docloader-DnUMWHaJ.d.cts

@@ -0,0 +1,202 @@
+/// <reference lib="esnext.temporal" />
+import { Logger } from "@logtape/logtape";
+
+//#region src/request.d.ts
+/**
+* Error thrown when fetching a JSON-LD document failed.
+*/
+declare class FetchError extends Error {
+  /**
+  * The URL that failed to fetch.
+  */
+  url: URL;
+  /**
+  * The HTTP response that failed, if available.
+  */
+  response?: Response;
+  /**
+  * Constructs a new `FetchError`.
+  *
+  * @param url The URL that failed to fetch.
+  * @param message Error message.
+  * @param response The failed HTTP response, if available.
+  */
+  constructor(url: URL | string, message?: string, response?: Response);
+}
+/**
+* Options for creating a request.
+* @internal
+*/
+interface CreateRequestOptions {
+  userAgent?: GetUserAgentOptions | string;
+}
+/**
+* Creates a request for the given URL.
+* @param url The URL to create the request for.
+* @param options The options for the request.
+* @returns The created request.
+* @internal
+*/
+declare function createActivityPubRequest(url: string, options?: CreateRequestOptions): Request;
+/**
+* Options for making `User-Agent` string.
+* @see {@link getUserAgent}
+* @since 1.3.0
+*/
+interface GetUserAgentOptions {
+  /**
+  * An optional software name and version, e.g., `"Hollo/1.0.0"`.
+  */
+  software?: string | null;
+  /**
+  * An optional URL to append to the user agent string.
+  * Usually the URL of the ActivityPub instance.
+  */
+  url?: string | URL | null;
+}
+/**
+* Gets the user agent string for the given application and URL.
+* @param options The options for making the user agent string.
+* @returns The user agent string.
+* @since 1.3.0
+*/
+declare function getUserAgent({
+  software,
+  url
+}?: GetUserAgentOptions): string;
+/**
+* Logs the request.
+* @param request The request to log.
+* @internal
+*/
+declare function logRequest(logger: Logger, request: Request): void;
+//#endregion
+//#region src/docloader.d.ts
+/**
+* A remote JSON-LD document and its context fetched by
+* a {@link DocumentLoader}.
+*/
+interface RemoteDocument {
+  /**
+  * The URL of the context document.
+  */
+  contextUrl: string | null;
+  /**
+  * The fetched JSON-LD document.
+  */
+  document: unknown;
+  /**
+  * The URL of the fetched document.
+  */
+  documentUrl: string;
+}
+/**
+* Options for {@link DocumentLoader}.
+* @since 1.8.0
+*/
+interface DocumentLoaderOptions {
+  /**
+  * An `AbortSignal` for cancellation.
+  * @since 1.8.0
+  */
+  signal?: AbortSignal;
+}
+/**
+* A JSON-LD document loader that fetches documents from the Web.
+* @param url The URL of the document to load.
+* @param options The options for the document loader.
+* @returns The loaded remote document.
+*/
+type DocumentLoader = (url: string, options?: DocumentLoaderOptions) => Promise<RemoteDocument>;
+/**
+* A factory function that creates a {@link DocumentLoader} with options.
+* @param options The options for the document loader.
+* @returns The document loader.
+* @since 1.4.0
+*/
+type DocumentLoaderFactory = (options?: DocumentLoaderFactoryOptions) => DocumentLoader;
+/**
+* Options for {@link DocumentLoaderFactory}.
+* @see {@link DocumentLoaderFactory}
+* @see {@link AuthenticatedDocumentLoaderFactory}
+* @since 1.4.0
+*/
+interface DocumentLoaderFactoryOptions {
+  /**
+  * Whether to allow fetching private network addresses.
+  * Turned off by default.
+  * @default `false``
+  */
+  allowPrivateAddress?: boolean;
+  /**
+  * Options for making `User-Agent` string.
+  * If a string is given, it is used as the `User-Agent` header value.
+  * If an object is given, it is passed to {@link getUserAgent} function.
+  */
+  userAgent?: GetUserAgentOptions | string;
+  /**
+  * The maximum number of redirections to follow.
+  * @default `20`
+  * @since 2.2.0
+  */
+  maxRedirection?: number;
+}
+/**
+* A factory function that creates an authenticated {@link DocumentLoader} for
+* a given identity.  This is used for fetching documents that require
+* authentication.
+* @param identity The identity to create the document loader for.
+*                 The actor's key pair.
+* @param options The options for the document loader.
+* @returns The authenticated document loader.
+* @since 0.4.0
+*/
+type AuthenticatedDocumentLoaderFactory = (identity: {
+  keyId: URL;
+  privateKey: CryptoKey;
+}, options?: DocumentLoaderFactoryOptions) => DocumentLoader;
+/**
+* Gets a {@link RemoteDocument} from the given response.
+* @param url The URL of the document to load.
+* @param response The response to get the document from.
+* @param fetch The function to fetch the document.
+* @returns The loaded remote document.
+* @throws {FetchError} If the response is not OK.
+* @internal
+*/
+declare function getRemoteDocument(url: string, response: Response, fetch: (url: string, options?: DocumentLoaderOptions) => Promise<RemoteDocument>): Promise<RemoteDocument>;
+/**
+* Options for {@link getDocumentLoader}.
+* @since 1.3.0
+*/
+interface GetDocumentLoaderOptions extends DocumentLoaderFactoryOptions {
+  /**
+  * Whether to preload the frequently used contexts.
+  */
+  skipPreloadedContexts?: boolean;
+}
+/**
+* Creates a JSON-LD document loader that utilizes the browser's `fetch` API.
+*
+* The created loader preloads the below frequently used contexts by default
+* (unless `options.skipPreloadedContexts` is set to `true`):
+*
+* - <https://www.w3.org/ns/activitystreams>
+* - <https://w3id.org/security/v1>
+* - <https://w3id.org/security/data-integrity/v1>
+* - <https://www.w3.org/ns/did/v1>
+* - <https://w3id.org/security/multikey/v1>
+* - <https://purl.archive.org/socialweb/webfinger>
+* - <http://schema.org/>
+* @param options Options for the document loader.
+* @returns The document loader.
+* @since 1.3.0
+*/
+declare function getDocumentLoader({
+  allowPrivateAddress,
+  maxRedirection,
+  skipPreloadedContexts,
+  userAgent
+}?: GetDocumentLoaderOptions): DocumentLoader;
+//#endregion
+export { DocumentLoaderOptions as a, getDocumentLoader as c, FetchError as d, GetUserAgentOptions as f, logRequest as h, DocumentLoaderFactoryOptions as i, getRemoteDocument as l, getUserAgent as m, DocumentLoader as n, GetDocumentLoaderOptions as o, createActivityPubRequest as p, DocumentLoaderFactory as r, RemoteDocument as s, AuthenticatedDocumentLoaderFactory as t, CreateRequestOptions as u };

package/dist/docloader-xRGn1azD.d.ts

@@ -0,0 +1,202 @@
+/// <reference lib="esnext.temporal" />
+import { Logger } from "@logtape/logtape";
+
+//#region src/request.d.ts
+/**
+* Error thrown when fetching a JSON-LD document failed.
+*/
+declare class FetchError extends Error {
+  /**
+  * The URL that failed to fetch.
+  */
+  url: URL;
+  /**
+  * The HTTP response that failed, if available.
+  */
+  response?: Response;
+  /**
+  * Constructs a new `FetchError`.
+  *
+  * @param url The URL that failed to fetch.
+  * @param message Error message.
+  * @param response The failed HTTP response, if available.
+  */
+  constructor(url: URL | string, message?: string, response?: Response);
+}
+/**
+* Options for creating a request.
+* @internal
+*/
+interface CreateRequestOptions {
+  userAgent?: GetUserAgentOptions | string;
+}
+/**
+* Creates a request for the given URL.
+* @param url The URL to create the request for.
+* @param options The options for the request.
+* @returns The created request.
+* @internal
+*/
+declare function createActivityPubRequest(url: string, options?: CreateRequestOptions): Request;
+/**
+* Options for making `User-Agent` string.
+* @see {@link getUserAgent}
+* @since 1.3.0
+*/
+interface GetUserAgentOptions {
+  /**
+  * An optional software name and version, e.g., `"Hollo/1.0.0"`.
+  */
+  software?: string | null;
+  /**
+  * An optional URL to append to the user agent string.
+  * Usually the URL of the ActivityPub instance.
+  */
+  url?: string | URL | null;
+}
+/**
+* Gets the user agent string for the given application and URL.
+* @param options The options for making the user agent string.
+* @returns The user agent string.
+* @since 1.3.0
+*/
+declare function getUserAgent({
+  software,
+  url
+}?: GetUserAgentOptions): string;
+/**
+* Logs the request.
+* @param request The request to log.
+* @internal
+*/
+declare function logRequest(logger: Logger, request: Request): void;
+//#endregion
+//#region src/docloader.d.ts
+/**
+* A remote JSON-LD document and its context fetched by
+* a {@link DocumentLoader}.
+*/
+interface RemoteDocument {
+  /**
+  * The URL of the context document.
+  */
+  contextUrl: string | null;
+  /**
+  * The fetched JSON-LD document.
+  */
+  document: unknown;
+  /**
+  * The URL of the fetched document.
+  */
+  documentUrl: string;
+}
+/**
+* Options for {@link DocumentLoader}.
+* @since 1.8.0
+*/
+interface DocumentLoaderOptions {
+  /**
+  * An `AbortSignal` for cancellation.
+  * @since 1.8.0
+  */
+  signal?: AbortSignal;
+}
+/**
+* A JSON-LD document loader that fetches documents from the Web.
+* @param url The URL of the document to load.
+* @param options The options for the document loader.
+* @returns The loaded remote document.
+*/
+type DocumentLoader = (url: string, options?: DocumentLoaderOptions) => Promise<RemoteDocument>;
+/**
+* A factory function that creates a {@link DocumentLoader} with options.
+* @param options The options for the document loader.
+* @returns The document loader.
+* @since 1.4.0
+*/
+type DocumentLoaderFactory = (options?: DocumentLoaderFactoryOptions) => DocumentLoader;
+/**
+* Options for {@link DocumentLoaderFactory}.
+* @see {@link DocumentLoaderFactory}
+* @see {@link AuthenticatedDocumentLoaderFactory}
+* @since 1.4.0
+*/
+interface DocumentLoaderFactoryOptions {
+  /**
+  * Whether to allow fetching private network addresses.
+  * Turned off by default.
+  * @default `false``
+  */
+  allowPrivateAddress?: boolean;
+  /**
+  * Options for making `User-Agent` string.
+  * If a string is given, it is used as the `User-Agent` header value.
+  * If an object is given, it is passed to {@link getUserAgent} function.
+  */
+  userAgent?: GetUserAgentOptions | string;
+  /**
+  * The maximum number of redirections to follow.
+  * @default `20`
+  * @since 2.2.0
+  */
+  maxRedirection?: number;
+}
+/**
+* A factory function that creates an authenticated {@link DocumentLoader} for
+* a given identity.  This is used for fetching documents that require
+* authentication.
+* @param identity The identity to create the document loader for.
+*                 The actor's key pair.
+* @param options The options for the document loader.
+* @returns The authenticated document loader.
+* @since 0.4.0
+*/
+type AuthenticatedDocumentLoaderFactory = (identity: {
+  keyId: URL;
+  privateKey: CryptoKey;
+}, options?: DocumentLoaderFactoryOptions) => DocumentLoader;
+/**
+* Gets a {@link RemoteDocument} from the given response.
+* @param url The URL of the document to load.
+* @param response The response to get the document from.
+* @param fetch The function to fetch the document.
+* @returns The loaded remote document.
+* @throws {FetchError} If the response is not OK.
+* @internal
+*/
+declare function getRemoteDocument(url: string, response: Response, fetch: (url: string, options?: DocumentLoaderOptions) => Promise<RemoteDocument>): Promise<RemoteDocument>;
+/**
+* Options for {@link getDocumentLoader}.
+* @since 1.3.0
+*/
+interface GetDocumentLoaderOptions extends DocumentLoaderFactoryOptions {
+  /**
+  * Whether to preload the frequently used contexts.
+  */
+  skipPreloadedContexts?: boolean;
+}
+/**
+* Creates a JSON-LD document loader that utilizes the browser's `fetch` API.
+*
+* The created loader preloads the below frequently used contexts by default
+* (unless `options.skipPreloadedContexts` is set to `true`):
+*
+* - <https://www.w3.org/ns/activitystreams>
+* - <https://w3id.org/security/v1>
+* - <https://w3id.org/security/data-integrity/v1>
+* - <https://www.w3.org/ns/did/v1>
+* - <https://w3id.org/security/multikey/v1>
+* - <https://purl.archive.org/socialweb/webfinger>
+* - <http://schema.org/>
+* @param options Options for the document loader.
+* @returns The document loader.
+* @since 1.3.0
+*/
+declare function getDocumentLoader({
+  allowPrivateAddress,
+  maxRedirection,
+  skipPreloadedContexts,
+  userAgent
+}?: GetDocumentLoaderOptions): DocumentLoader;
+//#endregion
+export { DocumentLoaderOptions as a, getDocumentLoader as c, FetchError as d, GetUserAgentOptions as f, logRequest as h, DocumentLoaderFactoryOptions as i, getRemoteDocument as l, getUserAgent as m, DocumentLoader as n, GetDocumentLoaderOptions as o, createActivityPubRequest as p, DocumentLoaderFactory as r, RemoteDocument as s, AuthenticatedDocumentLoaderFactory as t, CreateRequestOptions as u };

package/dist/internal/jsonld-cache.cjs

@@ -0,0 +1,279 @@
+
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_url = require("../url-BAdyyqAa.cjs");
+const require_jsonld = require("../jsonld.cjs");
+//#region src/internal/jsonld-cache.ts
+const noJsonLdContext = Symbol("noJsonLdContext");
+/**
+* Checks whether an IRI is trusted relative to another IRI.
+*
+* @internal Technically exported for generated vocabulary classes, but not
+* part of the public API contract.  This is not considered public API for
+* Semantic Versioning decisions.
+*/
+function isTrustedIriOrigin(options, left, right) {
+	return options.crossOrigin === "trust" || left == null || right != null && require_url.haveSameIriOrigin(left, right);
+}
+/**
+* Normalizes portable IRIs in JSON-LD cache data.
+*
+* @internal Technically exported for generated vocabulary classes, but not
+* part of the public API contract.  This is not considered public API for
+* Semantic Versioning decisions.
+*/
+function normalizeJsonLdIris(value, iriKeys, iriPattern = /^ap(?:\+ef61)?:\/\//i) {
+	return normalize(value, void 0, 0, void 0);
+	function isIriPosition(key, parentKey) {
+		return iriKeys.has(key) || (key === "@value" || key === "@list" || key === "@set") && parentKey != null && iriKeys.has(parentKey);
+	}
+	function arrayItemParentKey(key, parentKey) {
+		return key === "@list" || key === "@set" ? parentKey : key;
+	}
+	function entryParentKey(entryKey, key, parentKey) {
+		if (entryKey === "@list" || entryKey === "@set") return parentKey ?? key;
+		return key === "@list" || key === "@set" ? parentKey : key;
+	}
+	function normalize(value, key, depth = 0, parentKey) {
+		if (depth > 32 || key === "@context") return value;
+		if (typeof value === "string") {
+			if (key != null && isIriPosition(key, parentKey) && iriPattern.test(value)) try {
+				return require_url.formatIri(value);
+			} catch {
+				return value;
+			}
+			return value;
+		}
+		if (Array.isArray(value)) {
+			let clone;
+			const itemParentKey = arrayItemParentKey(key, parentKey);
+			for (let i = 0; i < value.length; i++) {
+				const result = normalize(value[i], key, depth + 1, itemParentKey);
+				if (result !== value[i]) {
+					clone ??= value.slice(0, i);
+					clone.push(result);
+				} else if (clone != null) clone.push(value[i]);
+			}
+			return clone ?? value;
+		}
+		if (value == null || typeof value !== "object") return value;
+		const object = value;
+		let clone;
+		for (const entryKey of globalThis.Object.keys(object)) {
+			const result = normalize(object[entryKey], entryKey, depth + 1, entryParentKey(entryKey, key, parentKey));
+			if (result !== object[entryKey]) {
+				clone ??= { ...object };
+				defineJsonLdProperty(clone, entryKey, result);
+			}
+		}
+		return clone ?? object;
+	}
+}
+/**
+* Finds the first JSON-LD context in a value.
+*
+* @internal Technically exported for generated vocabulary classes, but not
+* part of the public API contract.  This is not considered public API for
+* Semantic Versioning decisions.
+*/
+function getJsonLdContext(value, depth = 0) {
+	if (depth > 32) return void 0;
+	if (Array.isArray(value)) {
+		for (const item of value) {
+			const context = getJsonLdContext(item, depth + 1);
+			if (context !== void 0) return context;
+		}
+		return;
+	}
+	if (value == null || typeof value !== "object" || !("@context" in value)) return;
+	return value["@context"];
+}
+function getOwnJsonLdContext(value) {
+	if (value == null || typeof value !== "object" || Array.isArray(value) || !("@context" in value)) return noJsonLdContext;
+	return value["@context"];
+}
+/**
+* Recompacts normalized JSON-LD cache data against the original context.
+*
+* @internal Technically exported for generated vocabulary classes, but not
+* part of the public API contract.  This is not considered public API for
+* Semantic Versioning decisions.
+*/
+async function compactJsonLdCache(normalized, original, documentLoader, depth = 0, inheritedContext) {
+	if (depth > 32) return normalized;
+	if (Array.isArray(original)) {
+		const normalizedArray = Array.isArray(normalized) ? normalized : normalized != null && typeof normalized === "object" && "@graph" in normalized && Array.isArray(normalized["@graph"]) ? normalized["@graph"] : void 0;
+		if (normalizedArray == null) return normalized;
+		let clone;
+		for (let i = 0; i < normalizedArray.length; i++) {
+			const item = await compactJsonLdCache(normalizedArray[i], original[i], documentLoader, depth + 1, inheritedContext);
+			if (item !== normalizedArray[i]) {
+				clone ??= normalizedArray.slice(0, i);
+				clone.push(item);
+			} else if (clone != null) clone.push(normalizedArray[i]);
+		}
+		return clone ?? (Array.isArray(normalized) ? normalized : normalizedArray);
+	}
+	const ownContext = getOwnJsonLdContext(original);
+	const context = ownContext === noJsonLdContext ? inheritedContext : ownContext;
+	if (context == null) return preserveNoContextJsonLdShape(normalized, original, depth);
+	return await preserveJsonLdShape(await mergeUnmappedTerms(await require_jsonld.compact(Array.isArray(normalized) && normalized.length === 1 ? normalized[0] : normalized, context, { documentLoader }), original, context, documentLoader), original, context, documentLoader, depth);
+}
+function preserveNoContextJsonLdShape(normalized, original, depth = 0) {
+	if (depth > 32) return normalized;
+	if (original == null || typeof original !== "object" || Array.isArray(original)) return normalized;
+	const normalizedObject = Array.isArray(normalized) && normalized.length === 1 ? normalized[0] : normalized;
+	if (normalizedObject == null || typeof normalizedObject !== "object" || Array.isArray(normalizedObject)) return normalized;
+	const source = normalizedObject;
+	const originalObject = original;
+	let clone;
+	for (const key of globalThis.Object.keys(originalObject)) {
+		if (!globalThis.Object.prototype.hasOwnProperty.call(source, key)) continue;
+		const value = preserveNoContextValue(source[key], originalObject[key], depth + 1);
+		if (value !== originalObject[key]) {
+			clone ??= { ...originalObject };
+			defineJsonLdProperty(clone, key, value);
+		}
+	}
+	return clone ?? original;
+}
+function preserveNoContextValue(normalized, original, depth) {
+	if (depth > 32) return normalized;
+	if (Array.isArray(original)) {
+		const normalizedArray = Array.isArray(normalized) ? normalized : [normalized];
+		let clone;
+		for (let i = 0; i < original.length; i++) {
+			const value = preserveNoContextValue(normalizedArray[i], original[i], depth + 1);
+			if (value !== original[i]) {
+				clone ??= original.slice(0, i);
+				clone.push(value);
+			} else if (clone != null) clone.push(original[i]);
+		}
+		return clone ?? original;
+	}
+	const normalizedValue = Array.isArray(normalized) ? normalized[0] : normalized;
+	if (normalizedValue == null || typeof normalizedValue !== "object" || Array.isArray(normalizedValue)) return normalizedValue;
+	const normalizedObject = normalizedValue;
+	if (original != null && typeof original === "object" && !Array.isArray(original)) return preserveNoContextJsonLdShape(normalizedObject, original, depth + 1);
+	if (typeof normalizedObject["@id"] === "string") return normalizedObject["@id"];
+	if ("@value" in normalizedObject) return normalizedObject["@value"];
+	return normalizedValue;
+}
+function getTopLevelTerms(value) {
+	const terms = /* @__PURE__ */ new Set();
+	const nodes = Array.isArray(value) ? value : [value];
+	for (const node of nodes) {
+		if (node == null || typeof node !== "object" || Array.isArray(node)) continue;
+		for (const key of globalThis.Object.keys(node)) {
+			if (key.startsWith("@")) continue;
+			terms.add(key);
+		}
+	}
+	return terms;
+}
+async function mergeUnmappedTerms(compacted, original, context, documentLoader) {
+	if (original == null || typeof original !== "object" || Array.isArray(original) || compacted == null || typeof compacted !== "object" || Array.isArray(compacted)) return compacted;
+	const unmappedKeys = globalThis.Object.keys(original).filter((key) => key !== "@context" && !globalThis.Object.prototype.hasOwnProperty.call(compacted, key));
+	if (unmappedKeys.length < 1) return compacted;
+	const result = { ...compacted };
+	const compactedWithContext = compacted != null && typeof compacted === "object" && !Array.isArray(compacted) && !("@context" in compacted) ? {
+		"@context": context,
+		...compacted
+	} : compacted;
+	const compactedTerms = getTopLevelTerms(await require_jsonld.expand(compactedWithContext, { documentLoader }));
+	const dummyPrefix = "urn:fedify:dummy:";
+	const dummy = { "@context": context };
+	for (let i = 0; i < unmappedKeys.length; i++) defineJsonLdProperty(dummy, unmappedKeys[i], `${dummyPrefix}${i}`);
+	const expanded = await require_jsonld.expand(dummy, { documentLoader });
+	const representedKeys = /* @__PURE__ */ new Set();
+	const nodes = Array.isArray(expanded) ? expanded : [expanded];
+	for (const node of nodes) {
+		if (node == null || typeof node !== "object" || Array.isArray(node)) continue;
+		for (const [term, termValue] of globalThis.Object.entries(node)) {
+			if (!compactedTerms.has(term)) continue;
+			for (let i = 0; i < unmappedKeys.length; i++) if (containsValue(termValue, `${dummyPrefix}${i}`)) representedKeys.add(unmappedKeys[i]);
+		}
+	}
+	for (const key of unmappedKeys) if (!representedKeys.has(key)) defineJsonLdProperty(result, key, original[key]);
+	return result;
+}
+function defineJsonLdProperty(object, key, value) {
+	globalThis.Object.defineProperty(object, key, {
+		value,
+		enumerable: true,
+		configurable: true,
+		writable: true
+	});
+}
+function containsValue(value, expected, depth = 0) {
+	if (depth > 32) return false;
+	if (value === expected) return true;
+	if (Array.isArray(value)) return value.some((item) => containsValue(item, expected, depth + 1));
+	if (value == null || typeof value !== "object") return false;
+	return globalThis.Object.entries(value).some(([key, item]) => key !== "@context" && containsValue(item, expected, depth + 1));
+}
+async function preserveJsonLdShape(compacted, original, context, documentLoader, depth = 0) {
+	if (depth > 32) return compacted;
+	if (compacted === original) return compacted;
+	if (original == null || typeof original !== "object" || compacted == null || typeof compacted !== "object") return compacted;
+	if (Array.isArray(original)) {
+		const compactedArray = Array.isArray(compacted) ? compacted : "@graph" in compacted && Array.isArray(compacted["@graph"]) ? compacted["@graph"] : void 0;
+		if (compactedArray == null) return compacted;
+		let clone;
+		for (let i = 0; i < compactedArray.length; i++) {
+			const value = await preserveJsonLdShape(compactedArray[i], original[i], context, documentLoader, depth + 1);
+			const originalContext = original[i] != null && typeof original[i] === "object" && !Array.isArray(original[i]) && "@context" in original[i] ? original[i]["@context"] : void 0;
+			const shaped = originalContext !== void 0 && value != null && typeof value === "object" && !Array.isArray(value) && !("@context" in value) ? {
+				"@context": originalContext,
+				...value
+			} : value;
+			if (shaped !== compactedArray[i]) {
+				clone ??= compactedArray.slice(0, i);
+				clone.push(shaped);
+			} else if (clone != null) clone.push(compactedArray[i]);
+		}
+		return clone ?? (Array.isArray(compacted) ? compacted : compactedArray);
+	}
+	if (Array.isArray(compacted)) return compacted;
+	let clone;
+	const ownContext = getOwnJsonLdContext(original);
+	const objectContext = combineContexts(context, ownContext);
+	const objectCompacted = depth > 0 && ownContext === null ? await compactWithEmptyContext(compacted, context, documentLoader) : compacted;
+	const compactedObject = depth > 0 ? await mergeUnmappedTerms(objectCompacted, original, objectContext, documentLoader) : objectCompacted;
+	const originalObject = original;
+	for (const key of globalThis.Object.keys(compactedObject)) {
+		if (key === "@context") continue;
+		const value = await preserveJsonLdShape(compactedObject[key], originalObject[key], objectContext, documentLoader, depth + 1);
+		const shaped = Array.isArray(originalObject[key]) && !Array.isArray(value) ? [value] : value;
+		if (shaped !== compactedObject[key]) {
+			clone ??= { ...compactedObject };
+			defineJsonLdProperty(clone, key, shaped);
+		}
+	}
+	if (depth > 0) {
+		if ("@context" in originalObject && !("@context" in compactedObject)) {
+			clone ??= { ...compactedObject };
+			clone["@context"] = originalObject["@context"];
+		}
+	}
+	return clone ?? compactedObject;
+}
+async function compactWithEmptyContext(compacted, context, documentLoader) {
+	const compactedWithContext = compacted != null && typeof compacted === "object" && !Array.isArray(compacted) && !("@context" in compacted) ? {
+		"@context": context,
+		...compacted
+	} : compacted;
+	const expanded = await require_jsonld.expand(compactedWithContext, { documentLoader });
+	return await require_jsonld.compact(expanded, {}, { documentLoader });
+}
+function combineContexts(inheritedContext, ownContext) {
+	if (ownContext === noJsonLdContext || ownContext === inheritedContext) return inheritedContext;
+	if (ownContext == null) return ownContext;
+	const inherited = Array.isArray(inheritedContext) ? inheritedContext : [inheritedContext];
+	const own = Array.isArray(ownContext) ? ownContext : [ownContext];
+	return [...inherited, ...own];
+}
+//#endregion
+exports.compactJsonLdCache = compactJsonLdCache;
+exports.getJsonLdContext = getJsonLdContext;
+exports.isTrustedIriOrigin = isTrustedIriOrigin;
+exports.normalizeJsonLdIris = normalizeJsonLdIris;