@fedify/vocab-runtime 2.4.0 → 2.4.1

package/dist/tests/langtag-CUppHs_s.mjs

@@ -0,0 +1,45 @@
+//#region src/langtag.ts
+const EXTLANG_PAIRS = new Set(Object.entries({
+	ar: "aao abh abv acm acq acw acx acy adf aeb aec afb ajp apc apd arb arq ars ary arz auz avl ayh ayl ayn ayp bbz pga shu ssh",
+	kok: "gom knn",
+	lv: "ltg lvs",
+	ms: "bjn btj bve bvu coa dup hji jak jax kvb kvr kxd lce lcf liw max meo mfa mfb min mqg msi mui orn ors pel pse tmw urk vkk vkt xmm zlm zmi zsm",
+	sgn: "ads aed aen afg ajs ase asf asp asq asw bfi bfk bog bqn bqy bvl bzs cds csc csd cse csf csg csl csn csq csr csx doq dse dsl dsz dyl ecs ehs esl esn eso eth fcs fse fsl fss gds gse gsg gsm gss gus hab haf hds hks hos hps hsh hsl icl iks ils inl ins ise isg isr jcs jhs jks jls jos jsl jus kgi kvk lbs lgs lls lsb lsc lsg lsl lsn lso lsp lst lsv lsw lsy lws mdl mfs mre msd msr mzc mzg mzy nbs ncs nsi nsl nsp nsr nzs okl pgz pks prl prz psc psd psg psl pso psp psr pys rib rms rnb rsi rsl rsm rsn sdl sfb sfs sgg sgx slf sls sqk sqs sqx ssp ssr svk swl syy szs tse tsm tsq tss tsy tza ugn ugy ukl uks vgt vsi vsl vsv wbs xki xml xms yds ygs yhs ysl ysm zhk zib zsl",
+	sw: "swc swh",
+	uz: "uzn uzs",
+	zh: "cdo cjy cmn cnp cpx csp czh czo gan hak hnm hsn luh lzh mnp nan sjc wuu yue"
+}).flatMap(([prefix, extlangs]) => extlangs.split(" ").map((extlang) => `${prefix}-${extlang}`)));
+const PREFIX_PATTERN = /^[A-Za-z]{2,3}$/;
+const EXTLANG_PATTERN = /^[A-Za-z]{3}$/;
+/**
+* Normalizes a BCP 47 language tag that has an extended language subtag
+* (extlang), such as `zh-yue`, into its canonical form, such as `yue`, as
+* described in [RFC 5646, Section 4.5][1].  `Intl.Locale` rejects extlang
+* tags, so tags should be normalized before being passed to it.
+*
+* Only registered extlangs that follow their registered prefix are removed;
+* any other tag is returned unchanged, so the result still needs to be
+* validated, e.g., by `Intl.Locale`.
+*
+* NOTE: This function is marked as internal in the 2.0.x–2.4.x patch
+* releases.  When merging it into the *main* branch, remove the `@internal`
+* tag, formalize it as a public API (`@since 2.5.0`), and add it to
+* the changelog fragment.
+*
+* [1]: https://www.rfc-editor.org/rfc/rfc5646.html#section-4.5
+*
+* @param tag The BCP 47 language tag to normalize.
+* @returns The normalized language tag.
+* @internal
+*/
+function normalizeLanguageTag(tag) {
+	const subtags = tag.split("-");
+	if (subtags.length < 2) return tag;
+	const [prefix, extlang, ...rest] = subtags;
+	if (!PREFIX_PATTERN.test(prefix) || !EXTLANG_PATTERN.test(extlang)) return tag;
+	const language = extlang.toLowerCase();
+	if (!EXTLANG_PAIRS.has(`${prefix.toLowerCase()}-${language}`)) return tag;
+	return [language, ...rest].join("-");
+}
+//#endregion
+export { normalizeLanguageTag as t };

package/dist/tests/langtag-Czjvxfzx.cjs

@@ -0,0 +1,50 @@
+//#region src/langtag.ts
+const EXTLANG_PAIRS = new Set(Object.entries({
+	ar: "aao abh abv acm acq acw acx acy adf aeb aec afb ajp apc apd arb arq ars ary arz auz avl ayh ayl ayn ayp bbz pga shu ssh",
+	kok: "gom knn",
+	lv: "ltg lvs",
+	ms: "bjn btj bve bvu coa dup hji jak jax kvb kvr kxd lce lcf liw max meo mfa mfb min mqg msi mui orn ors pel pse tmw urk vkk vkt xmm zlm zmi zsm",
+	sgn: "ads aed aen afg ajs ase asf asp asq asw bfi bfk bog bqn bqy bvl bzs cds csc csd cse csf csg csl csn csq csr csx doq dse dsl dsz dyl ecs ehs esl esn eso eth fcs fse fsl fss gds gse gsg gsm gss gus hab haf hds hks hos hps hsh hsl icl iks ils inl ins ise isg isr jcs jhs jks jls jos jsl jus kgi kvk lbs lgs lls lsb lsc lsg lsl lsn lso lsp lst lsv lsw lsy lws mdl mfs mre msd msr mzc mzg mzy nbs ncs nsi nsl nsp nsr nzs okl pgz pks prl prz psc psd psg psl pso psp psr pys rib rms rnb rsi rsl rsm rsn sdl sfb sfs sgg sgx slf sls sqk sqs sqx ssp ssr svk swl syy szs tse tsm tsq tss tsy tza ugn ugy ukl uks vgt vsi vsl vsv wbs xki xml xms yds ygs yhs ysl ysm zhk zib zsl",
+	sw: "swc swh",
+	uz: "uzn uzs",
+	zh: "cdo cjy cmn cnp cpx csp czh czo gan hak hnm hsn luh lzh mnp nan sjc wuu yue"
+}).flatMap(([prefix, extlangs]) => extlangs.split(" ").map((extlang) => `${prefix}-${extlang}`)));
+const PREFIX_PATTERN = /^[A-Za-z]{2,3}$/;
+const EXTLANG_PATTERN = /^[A-Za-z]{3}$/;
+/**
+* Normalizes a BCP 47 language tag that has an extended language subtag
+* (extlang), such as `zh-yue`, into its canonical form, such as `yue`, as
+* described in [RFC 5646, Section 4.5][1].  `Intl.Locale` rejects extlang
+* tags, so tags should be normalized before being passed to it.
+*
+* Only registered extlangs that follow their registered prefix are removed;
+* any other tag is returned unchanged, so the result still needs to be
+* validated, e.g., by `Intl.Locale`.
+*
+* NOTE: This function is marked as internal in the 2.0.x–2.4.x patch
+* releases.  When merging it into the *main* branch, remove the `@internal`
+* tag, formalize it as a public API (`@since 2.5.0`), and add it to
+* the changelog fragment.
+*
+* [1]: https://www.rfc-editor.org/rfc/rfc5646.html#section-4.5
+*
+* @param tag The BCP 47 language tag to normalize.
+* @returns The normalized language tag.
+* @internal
+*/
+function normalizeLanguageTag(tag) {
+	const subtags = tag.split("-");
+	if (subtags.length < 2) return tag;
+	const [prefix, extlang, ...rest] = subtags;
+	if (!PREFIX_PATTERN.test(prefix) || !EXTLANG_PATTERN.test(extlang)) return tag;
+	const language = extlang.toLowerCase();
+	if (!EXTLANG_PAIRS.has(`${prefix.toLowerCase()}-${language}`)) return tag;
+	return [language, ...rest].join("-");
+}
+//#endregion
+Object.defineProperty(exports, "normalizeLanguageTag", {
+	enumerable: true,
+	get: function() {
+		return normalizeLanguageTag;
+	}
+});

package/dist/tests/langtag.test.cjs

@@ -0,0 +1,45 @@
+const require_langtag = require("./langtag-Czjvxfzx.cjs");
+let node_test = require("node:test");
+let node_assert = require("node:assert");
+//#region src/langtag.test.ts
+(0, node_test.test)("normalizeLanguageTag() removes extlang subtags", () => {
+	for (const [input, expected] of [
+		["zh-yue", "yue"],
+		["zh-YUE", "yue"],
+		["ZH-Yue-hk", "yue-hk"],
+		["zh-yue-HK", "yue-HK"],
+		["zh-cmn-Hant", "cmn-Hant"],
+		["zh-yue-u-nu-hanidec", "yue-u-nu-hanidec"],
+		["sgn-ase", "ase"],
+		["ar-arz", "arz"],
+		["ms-zlm", "zlm"],
+		["kok-gom", "gom"],
+		["koK-gom", "gom"],
+		["lv-ltg", "ltg"],
+		["sw-swc", "swc"],
+		["uz-uzs", "uzs"],
+		["zh-yue-cmn", "yue-cmn"],
+		["zh-yue-", "yue-"]
+	]) (0, node_assert.deepStrictEqual)(require_langtag.normalizeLanguageTag(input), expected, input);
+});
+(0, node_test.test)("normalizeLanguageTag() leaves other tags unchanged", () => {
+	for (const tag of [
+		"",
+		"en",
+		"en-US",
+		"en-USA",
+		"en-yue",
+		"zh",
+		"zh-Hant-TW",
+		"yue",
+		"yue-HK",
+		"x-private",
+		"i-klingon",
+		"zh-min-nan",
+		"koK-gom",
+		"zh-yuK",
+		"constructor-yue",
+		"toString-yue"
+	]) (0, node_assert.deepStrictEqual)(require_langtag.normalizeLanguageTag(tag), tag, tag);
+});
+//#endregion

package/dist/tests/langtag.test.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/tests/langtag.test.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/tests/langtag.test.mjs

@@ -0,0 +1,46 @@
+import { t as normalizeLanguageTag } from "./langtag-CUppHs_s.mjs";
+import { test } from "node:test";
+import { deepStrictEqual } from "node:assert";
+//#region src/langtag.test.ts
+test("normalizeLanguageTag() removes extlang subtags", () => {
+	for (const [input, expected] of [
+		["zh-yue", "yue"],
+		["zh-YUE", "yue"],
+		["ZH-Yue-hk", "yue-hk"],
+		["zh-yue-HK", "yue-HK"],
+		["zh-cmn-Hant", "cmn-Hant"],
+		["zh-yue-u-nu-hanidec", "yue-u-nu-hanidec"],
+		["sgn-ase", "ase"],
+		["ar-arz", "arz"],
+		["ms-zlm", "zlm"],
+		["kok-gom", "gom"],
+		["koK-gom", "gom"],
+		["lv-ltg", "ltg"],
+		["sw-swc", "swc"],
+		["uz-uzs", "uzs"],
+		["zh-yue-cmn", "yue-cmn"],
+		["zh-yue-", "yue-"]
+	]) deepStrictEqual(normalizeLanguageTag(input), expected, input);
+});
+test("normalizeLanguageTag() leaves other tags unchanged", () => {
+	for (const tag of [
+		"",
+		"en",
+		"en-US",
+		"en-USA",
+		"en-yue",
+		"zh",
+		"zh-Hant-TW",
+		"yue",
+		"yue-HK",
+		"x-private",
+		"i-klingon",
+		"zh-min-nan",
+		"koK-gom",
+		"zh-yuK",
+		"constructor-yue",
+		"toString-yue"
+	]) deepStrictEqual(normalizeLanguageTag(tag), tag, tag);
+});
+//#endregion
+export {};

package/dist/tests/{portable-dereference-DRE5bz-l.mjs → portable-dereference-DmTYDy2p.mjs}

@@ -1,6 +1,7 @@
-import { t as preloadedContexts } from "./contexts-CIKsin4e.mjs";
+import { t as preloadedContexts } from "./contexts-duRA_dDC.mjs";
 import { h as parseGatewayOrigin, o as formatIri, s as fromCompatibleEf61Id, t as GATEWAY_HINT_PARAMETER, u as haveSameFe34Origin } from "./url-DMxmp7ZG.mjs";
-import { c as unwrapReleasedDocumentLoader, s as registerDocumentLoaderWrapper } from "./jsonld-cache-BPQmOZWD.mjs";
+import "./jsonld-DweIJ07b.mjs";
+import { c as unwrapReleasedDocumentLoader, s as registerDocumentLoaderWrapper } from "./jsonld-cache-DFnWsLuZ.mjs";
 import { getLogger } from "@logtape/logtape";
 import "@opentelemetry/api";
 //#region src/internal/portable-dereference.ts

package/dist/tests/{portable-dereference-BNXtgg5U.cjs → portable-dereference-qTLMqe2_.cjs}

@@ -1,6 +1,7 @@
-const require_contexts = require("./contexts-DizzBjz4.cjs");
+const require_contexts = require("./contexts-C9Lj11SC.cjs");
 const require_url = require("./url-BNakuZ8k.cjs");
-const require_jsonld_cache = require("./jsonld-cache-C07AyNOY.cjs");
+require("./jsonld-CmDhHNTx.cjs");
+const require_jsonld_cache = require("./jsonld-cache-BEXiiM-V.cjs");
 let _logtape_logtape = require("@logtape/logtape");
 require("@opentelemetry/api");
 //#region src/internal/portable-dereference.ts

package/dist/tests/{portable-media-BLKllU56.cjs → portable-media-5p8azal0.cjs}

@@ -1,5 +1,5 @@
-const require_request = require("./request-8vPWtV1-.cjs");
-const require_body = require("./body-CkEwROsn.cjs");
+const require_request = require("./request-BgjA9wyl.cjs");
+const require_body = require("./body-cKLBprYm.cjs");
 const require_url = require("./url-BNakuZ8k.cjs");
 const require_digest = require("./digest-3FeH2Y-Q.cjs");
 //#region src/portable-media.ts

package/dist/tests/{portable-media-DRSGBORB.mjs → portable-media-B_lt9MMA.mjs}

@@ -1,5 +1,5 @@
-import { r as getUserAgent } from "./request-DRaOaTqD.mjs";
-import { r as readBoundedBytes } from "./body-CYiu9CO-.mjs";
+import { r as getUserAgent } from "./request-DodZNukP.mjs";
+import { r as readBoundedBytes } from "./body-DpC9p-iG.mjs";
 import { g as parseGatewayUrl, x as validatePublicUrl } from "./url-DMxmp7ZG.mjs";
 import { a as verifyDigestMultibase, i as parseHashlink, r as parseDigestMultibase } from "./digest-COC7xDiQ.mjs";
 //#region src/portable-media.ts

package/dist/tests/portable-media.test.cjs

@@ -1,5 +1,5 @@
 const require_digest = require("./digest-3FeH2Y-Q.cjs");
-const require_portable_media = require("./portable-media-BLKllU56.cjs");
+const require_portable_media = require("./portable-media-5p8azal0.cjs");
 let node_assert_strict = require("node:assert/strict");
 let node_test = require("node:test");
 let node_http = require("node:http");

package/dist/tests/portable-media.test.mjs

@@ -1,5 +1,5 @@
 import { n as createHashlink, t as computeDigestMultibase } from "./digest-COC7xDiQ.mjs";
-import { t as fetchPortableMedia } from "./portable-media-DRSGBORB.mjs";
+import { t as fetchPortableMedia } from "./portable-media-B_lt9MMA.mjs";
 import { deepStrictEqual, equal, rejects } from "node:assert/strict";
 import { test } from "node:test";
 import { createServer } from "node:http";

package/dist/tests/portable-workers.test.cjs

@@ -2,7 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_url = require("./url-BNakuZ8k.cjs");
 const require_key = require("./key-C-AYkdJJ.cjs");
 const require_digest = require("./digest-3FeH2Y-Q.cjs");
-const require_portable_dereference = require("./portable-dereference-BNXtgg5U.cjs");
+const require_portable_dereference = require("./portable-dereference-qTLMqe2_.cjs");
 let node_assert_strict = require("node:assert/strict");
 let _fedify_fixture = require("@fedify/fixture");
 //#region src/portable-workers.test.ts

package/dist/tests/portable-workers.test.mjs

@@ -1,7 +1,7 @@
 import { _ as parseIri, i as canonicalizePortableUri, o as formatIri, s as fromCompatibleEf61Id, y as toCompatibleEf61Id } from "./url-DMxmp7ZG.mjs";
 import { i as importDidKey, t as exportDidKey } from "./key-C2Db_TAJ.mjs";
 import { n as createHashlink, o as verifyHashlink, t as computeDigestMultibase } from "./digest-COC7xDiQ.mjs";
-import { n as getPortableGatewayCandidates } from "./portable-dereference-DRE5bz-l.mjs";
+import { n as getPortableGatewayCandidates } from "./portable-dereference-DmTYDy2p.mjs";
 import { deepStrictEqual, equal } from "node:assert/strict";
 import { test, testDefinitions } from "@fedify/fixture";
 //#region src/portable-workers.test.ts

package/dist/tests/{request-8vPWtV1-.cjs → request-BgjA9wyl.cjs}

@@ -3,7 +3,7 @@ let node_process = require("node:process");
 node_process = require_rolldown_runtime.__toESM(node_process, 1);
 //#region deno.json
 var name = "@fedify/vocab-runtime";
-var version = "2.4.0";
+var version = "2.4.1";
 //#endregion
 //#region src/request.ts
 /**

package/dist/tests/{request-DRaOaTqD.mjs → request-DodZNukP.mjs}

@@ -1,7 +1,7 @@
 import process from "node:process";
 //#region deno.json
 var name = "@fedify/vocab-runtime";
-var version = "2.4.0";
+var version = "2.4.1";
 //#endregion
 //#region src/request.ts
 /**

package/dist/tests/request.test.cjs

@@ -1,5 +1,5 @@
 const require_rolldown_runtime = require("./rolldown-runtime-emK7D4bc.cjs");
-const require_request = require("./request-8vPWtV1-.cjs");
+const require_request = require("./request-BgjA9wyl.cjs");
 let node_test = require("node:test");
 let node_process = require("node:process");
 node_process = require_rolldown_runtime.__toESM(node_process, 1);

package/dist/tests/request.test.mjs

@@ -1,4 +1,4 @@
-import { n as createActivityPubRequest, o as version, r as getUserAgent } from "./request-DRaOaTqD.mjs";
+import { n as createActivityPubRequest, o as version, r as getUserAgent } from "./request-DodZNukP.mjs";
 import { test } from "node:test";
 import process from "node:process";
 import { deepStrictEqual } from "node:assert";

package/dist/tests/signed-representation.test.cjs

@@ -1,4 +1,4 @@
-const require_contexts = require("./contexts-DizzBjz4.cjs");
+const require_contexts = require("./contexts-C9Lj11SC.cjs");
 let node_test = require("node:test");
 let node_assert = require("node:assert");
 //#region src/internal/signed-representation.ts

package/dist/tests/signed-representation.test.mjs

@@ -1,4 +1,4 @@
-import { t as preloadedContexts } from "./contexts-CIKsin4e.mjs";
+import { t as preloadedContexts } from "./contexts-duRA_dDC.mjs";
 import { test } from "node:test";
 import { deepStrictEqual, ok, strictEqual, throws } from "node:assert";
 //#region src/internal/signed-representation.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/vocab-runtime",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "homepage": "https://fedify.dev/",
   "repository": {
     "type": "git",

package/src/contexts/fep-6757.json

@@ -0,0 +1,12 @@
+{
+  "@context": {
+    "license": {
+      "@id": "http://purl.org/dc/terms/license",
+      "@type": "@id"
+    },
+    "preferredLicense": {
+      "@id": "https://w3id.org/fep/6757#preferredLicense",
+      "@type": "@id"
+    }
+  }
+}

package/src/contexts/joinmastodon.json

@@ -22,7 +22,7 @@
     "suspended": "toot:suspended",
     "attributionDomains": {
       "@id": "toot:attributionDomains",
-      "@type": "@id"
+      "@container": "@set"
     }
   }
 }

package/src/contexts.ts

@@ -9,6 +9,7 @@ import cidV1Context from "./contexts/cid-v1.json" with { type: "json" };
 import didV1 from "./contexts/did-v1.json" with { type: "json" };
 import fep22cd from "./contexts/fep-22cd.json" with { type: "json" };
 import fep5711 from "./contexts/fep-5711.json" with { type: "json" };
+import fep6757 from "./contexts/fep-6757.json" with { type: "json" };
 import fep7aa9 from "./contexts/fep-7aa9.json" with { type: "json" };
 import fepEf61 from "./contexts/fep-ef61.json" with { type: "json" };
 import gotosocial from "./contexts/gotosocial.json" with { type: "json" };
@@ -66,6 +67,13 @@ const preloadedContexts: Record<string, unknown> = {
   //      https://github.com/fedify-dev/fedify/issues/1078
   "https://w3id.org/fep/7aa9": fep7aa9,
 
+  // The FEP-6757 context is hosted on Codeberg Pages, whose outages can
+  // prevent documents with license metadata from being parsed.  Resolve it
+  // locally so parsing does not depend on the remote context server.
+  // See: https://w3id.org/fep/6757
+  //      https://github.com/fedify-dev/fedify/issues/1211
+  "https://w3id.org/fep/6757": fep6757,
+
   // Lemmy's context document is served as application/json without the JSON-LD
   // context Link header.  The default document loader treats that as a regular
   // JSON response instead of a JSON-LD context, so every Lemmy activity that

package/src/docloader.test.ts

@@ -17,6 +17,7 @@ import {
   resolveDocumentLoaderTimeout,
   withDocumentLoaderTimeout,
 } from "./docloader.ts";
+import jsonld from "./jsonld.ts";
 import { FetchError } from "./request.ts";
 import { UrlError } from "./url.ts";
 
@@ -477,6 +478,30 @@ test("getDocumentLoader()", async (t) => {
     }
   });
 
+  await t.step("preloaded Mastodon attribution domains", async () => {
+    const context = [
+      "https://www.w3.org/ns/activitystreams",
+      "http://joinmastodon.org/ns",
+    ];
+    const expanded = await jsonld.expand({
+      "@context": context,
+      id: "https://social.example/users/alice",
+      type: "Person",
+      attributionDomains: ["blog.example"],
+    }, { documentLoader: fetchDocumentLoader });
+    deepStrictEqual(expanded, [{
+      "@id": "https://social.example/users/alice",
+      "@type": ["https://www.w3.org/ns/activitystreams#Person"],
+      "http://joinmastodon.org/ns#attributionDomains": [
+        { "@value": "blog.example" },
+      ],
+    }]);
+    const compacted = await jsonld.compact(expanded, context, {
+      documentLoader: fetchDocumentLoader,
+    });
+    deepStrictEqual(compacted.attributionDomains, ["blog.example"]);
+  });
+
   // Controlled Identifiers v1.0 requires JSON-LD processors to treat this
   // context URL as already resolved.  A temporary W3C outage must not prevent
   // an otherwise valid document from being processed.
@@ -554,6 +579,129 @@ test("getDocumentLoader()", async (t) => {
     deepStrictEqual(fetchMock.callHistory.calls(url).length, 0);
   });
 
+  // A Codeberg Pages outage must not prevent loading or expanding FEP-6757.
+  // See: https://github.com/fedify-dev/fedify/issues/1211
+  fetchMock.get("https://w3id.org/fep/6757", { status: 502 });
+  await t.step("preloaded FEP-6757 context", async () => {
+    const url = "https://w3id.org/fep/6757";
+    deepStrictEqual(await fetchDocumentLoader(url), {
+      contextUrl: null,
+      documentUrl: url,
+      document: {
+        "@context": {
+          license: {
+            "@id": "http://purl.org/dc/terms/license",
+            "@type": "@id",
+          },
+          preferredLicense: {
+            "@id": "https://w3id.org/fep/6757#preferredLicense",
+            "@type": "@id",
+          },
+        },
+      },
+    });
+    deepStrictEqual(
+      await jsonld.expand({
+        "@context": ["https://www.w3.org/ns/activitystreams", url],
+        type: "Person",
+        license: "https://creativecommons.org/licenses/by/4.0/",
+        preferredLicense: "https://creativecommons.org/licenses/by-nc/4.0/",
+      }, { documentLoader: fetchDocumentLoader }),
+      [{
+        "@type": ["https://www.w3.org/ns/activitystreams#Person"],
+        "http://purl.org/dc/terms/license": [{
+          "@id": "https://creativecommons.org/licenses/by/4.0/",
+        }],
+        "https://w3id.org/fep/6757#preferredLicense": [{
+          "@id": "https://creativecommons.org/licenses/by-nc/4.0/",
+        }],
+      }],
+    );
+    deepStrictEqual(fetchMock.callHistory.calls(url).length, 0);
+  });
+
+  // A Codeberg Pages outage must not prevent expanding translation metadata.
+  // See: https://github.com/fedify-dev/fedify/issues/1214
+  fetchMock.get("https://w3id.org/fep/22cd", { status: 502 });
+  await t.step("preloaded FEP-22cd context", async () => {
+    const url = "https://w3id.org/fep/22cd";
+    const articleId = "https://example.com/articles/1";
+    const translatorId = "https://example.com/users/alice";
+    const revisionId = "https://example.com/articles/1/revisions/1";
+    deepStrictEqual(await fetchDocumentLoader(url), {
+      contextUrl: null,
+      documentUrl: url,
+      document: {
+        "@context": {
+          "fep-22cd": "https://w3id.org/fep/22cd#",
+          schema: "https://schema.org/",
+          xsd: "http://www.w3.org/2001/XMLSchema#",
+          translations: {
+            "@id": "fep-22cd:translations",
+            "@container": "@set",
+          },
+          Translation: "fep-22cd:Translation",
+          sourceUpdated: {
+            "@id": "fep-22cd:sourceUpdated",
+            "@type": "xsd:dateTime",
+          },
+          translator: {
+            "@id": "schema:translator",
+            "@type": "@id",
+            "@container": "@set",
+          },
+          inLanguage: "schema:inLanguage",
+          translationOfWork: {
+            "@id": "schema:translationOfWork",
+            "@type": "@id",
+          },
+          isBasedOn: { "@id": "schema:isBasedOn", "@type": "@id" },
+        },
+      },
+    });
+    deepStrictEqual(
+      await jsonld.expand({
+        "@context": ["https://www.w3.org/ns/activitystreams", url],
+        id: articleId,
+        type: "Article",
+        contentMap: { en: "Original", ko: "Translation" },
+        translations: [{
+          type: "Translation",
+          inLanguage: "ko",
+          translator: [translatorId],
+          translationOfWork: articleId,
+          sourceUpdated: "2026-09-01T00:00:00Z",
+          isBasedOn: revisionId,
+        }],
+      }, { documentLoader: fetchDocumentLoader }),
+      [{
+        "@id": articleId,
+        "@type": ["https://www.w3.org/ns/activitystreams#Article"],
+        "https://www.w3.org/ns/activitystreams#content": [
+          { "@language": "en", "@value": "Original" },
+          { "@language": "ko", "@value": "Translation" },
+        ],
+        "https://w3id.org/fep/22cd#translations": [{
+          "@type": ["https://w3id.org/fep/22cd#Translation"],
+          "https://schema.org/inLanguage": [{ "@value": "ko" }],
+          "https://schema.org/translator": [{ "@id": translatorId }],
+          "https://schema.org/translationOfWork": [{ "@id": articleId }],
+          "https://w3id.org/fep/22cd#sourceUpdated": [{
+            "@type": "http://www.w3.org/2001/XMLSchema#dateTime",
+            "@value": "2026-09-01T00:00:00Z",
+          }],
+          "https://schema.org/isBasedOn": [{ "@id": revisionId }],
+        }],
+      }],
+    );
+    deepStrictEqual(fetchMock.callHistory.calls(url).length, 0);
+    deepStrictEqual(
+      fetchMock.callHistory.calls("https://www.w3.org/ns/activitystreams")
+        .length,
+      0,
+    );
+  });
+
   await t.step("deny non-HTTP/HTTPS", async () => {
     await rejects(
       () => fetchDocumentLoader("ftp://localhost"),

package/src/docloader.ts

@@ -528,6 +528,8 @@ export interface GetDocumentLoaderOptions extends DocumentLoaderFactoryOptions {
  * - <https://w3id.org/security/multikey/v1>
  * - <https://w3id.org/fep/ef61>
  * - <https://w3id.org/fep/7aa9>
+ * - <https://w3id.org/fep/6757>
+ * - <https://w3id.org/fep/22cd>
  * - <https://purl.archive.org/socialweb/webfinger>
  * - <http://schema.org/>
  * @param options Options for the document loader.

package/src/langstr.test.ts

@@ -1,4 +1,4 @@
-import { deepStrictEqual } from "node:assert";
+import { deepStrictEqual, throws } from "node:assert";
 import { test } from "node:test";
 import util from "node:util";
 import { LanguageString } from "./langstr.ts";
@@ -11,6 +11,23 @@ test("new LanguageString()", () => {
   deepStrictEqual(new LanguageString("Hello", new Intl.Locale("en")), langStr);
 });
 
+test("new LanguageString() with extlang tags", () => {
+  // Intl.Locale objects have no own enumerable properties, so their base names
+  // are compared instead:
+  deepStrictEqual(new LanguageString("你好", "zh-YUE").locale.baseName, "yue");
+  deepStrictEqual(
+    new LanguageString("你好", "zh-yue-HK").locale.baseName,
+    "yue-HK",
+  );
+  // Whether cmn is canonicalized to zh depends on the runtime:
+  deepStrictEqual(
+    new LanguageString("你好", "zh-cmn-Hant").locale.baseName,
+    new Intl.Locale("cmn-Hant").baseName,
+  );
+  throws(() => new LanguageString("Hello", "en-USA"), RangeError);
+  throws(() => new LanguageString("你好", "zh-yue-"), RangeError);
+});
+
 test("Deno.inspect(LanguageString)", () => {
   const langStr = new LanguageString("Hello, 'world'", "en");
   deepStrictEqual(

package/src/langstr.ts

@@ -1,3 +1,5 @@
+import { normalizeLanguageTag } from "./langtag.ts";
+
 /**
  * A language-tagged string which corresponds to the `rdf:langString` type.
  */
@@ -12,12 +14,14 @@ export class LanguageString extends String {
    * Constructs a new `LanguageString`.
    * @param value A string value written in the given language.
    * @param language The language of the string.  If a string is given, it will
-   *                 be parsed as a `Intl.Locale` object.
+   *                 be parsed as a `Intl.Locale` object.  Extended language
+   *                 subtags are normalized first, e.g., `zh-yue` is parsed as
+   *                 `yue`.
    */
   constructor(value: string, language: Intl.Locale | string) {
     super(value);
     this.locale = typeof language === "string"
-      ? new Intl.Locale(language)
+      ? new Intl.Locale(normalizeLanguageTag(language))
       : language;
   }
 }