Support FEP-ef61 portable ActivityPub IRIs in vocab codecs

CHANGES.md

@@ -8,6 +8,18 @@ Version 2.4.0
 
 To be released.
 
+### @fedify/vocab
+
+ -  Added support for [FEP-ef61] portable ActivityPub IRIs in generated
+    vocabulary codecs.  `ap:` and `ap+ef61:` values with decoded or
+    percent-encoded DID authorities now parse as `URL` objects, and JSON-LD
+    serialization emits canonical `ap+ef61:` values with decoded DID
+    authorities.  [[#826], [#850]]
+
+[FEP-ef61]: https://w3id.org/fep/ef61
+[#826]: https://github.com/fedify-dev/fedify/issues/826
+[#850]: https://github.com/fedify-dev/fedify/pull/850
+
 
 Version 2.3.1
 -------------

docs/manual/vocab.md

@@ -108,12 +108,19 @@ const create = new Create({
 Note that every URI is represented as a [`URL`] object.  This is for
 distinguishing the URIs from the other strings.
 
+Fedify also accepts [FEP-ef61] portable ActivityPub IRIs in JSON-LD input.
+Both the `ap:` and `ap+ef61:` schemes are accepted, whether the DID authority
+is decoded (e.g., `ap+ef61://did:key:.../actor`) or percent-encoded.  Fedify
+stores these IRIs as `URL` objects with a URL-safe authority internally, and
+serializes them as canonical `ap+ef61:` IRIs with the decoded DID authority.
+
 > [!TIP]
 > You can instantiate an object from a JSON-LD document by calling the
 > `fromJsonLd()` method of the object.  See the [*JSON-LD* section](#json-ld)
 > for details.
 
 [`URL`]: https://developer.mozilla.org/en-US/docs/Web/API/URL
+[FEP-ef61]: https://w3id.org/fep/ef61
 
 
 Properties

packages/vocab-runtime/deno.json

@@ -4,6 +4,7 @@
   "license": "MIT",
   "exports": {
     ".": "./src/mod.ts",
+    "./internal/jsonld-cache": "./src/internal/jsonld-cache.ts",
     "./jsonld": "./src/jsonld.ts",
     "./temporal": "./src/temporal.ts"
   },

packages/vocab-runtime/package.json

@@ -42,6 +42,16 @@
       "require": "./dist/jsonld.cjs",
       "default": "./dist/jsonld.js"
     },
+    "./internal/jsonld-cache": {
+      "types": {
+        "import": "./dist/internal/jsonld-cache.d.ts",
+        "require": "./dist/internal/jsonld-cache.d.cts",
+        "default": "./dist/internal/jsonld-cache.d.ts"
+      },
+      "import": "./dist/internal/jsonld-cache.js",
+      "require": "./dist/internal/jsonld-cache.cjs",
+      "default": "./dist/internal/jsonld-cache.js"
+    },
     "./temporal": {
       "types": {
         "import": "./dist/temporal.d.ts",