@fedify/vocab 2.3.0-dev.1274 → 2.3.0-dev.1280

package/dist/mod.d.cts

@@ -1,5 +1,5 @@
 /// <reference lib="esnext.temporal" />
-import { Decimal, DocumentLoader, DocumentLoader as DocumentLoader$1, GetUserAgentOptions, GetUserAgentOptions as GetUserAgentOptions$1, LanguageString, LanguageString as LanguageString$1, RemoteDocument } from "@fedify/vocab-runtime";
+import { Decimal, DocumentLoader, DocumentLoader as DocumentLoader$1, GetUserAgentOptions, GetUserAgentOptions as GetUserAgentOptions$1, LanguageString, LanguageString as LanguageString$1, PropertyPreprocessor, RemoteDocument } from "@fedify/vocab-runtime";
 import { MeterProvider, Span, TracerProvider } from "@opentelemetry/api";
 
 //#region src/vocab.d.ts
@@ -22,6 +22,7 @@ declare class Object$1 {
   } | undefined;
   protected get _cachedJsonLd(): unknown | undefined;
   protected set _cachedJsonLd(value: unknown | undefined);
+  protected get _baseUrl(): URL | undefined;
   /**
   * The type URI of {@link Object}: `https://www.w3.org/ns/activitystreams#Object`.
   */
@@ -1918,6 +1919,7 @@ declare class PropertyValue {
   } | undefined;
   protected get _cachedJsonLd(): unknown | undefined;
   protected set _cachedJsonLd(value: unknown | undefined);
+  protected get _baseUrl(): URL | undefined;
   /**
   * The type URI of {@link PropertyValue}: `http://schema.org#PropertyValue`.
   */
@@ -2012,6 +2014,7 @@ declare class Measure {
   } | undefined;
   protected get _cachedJsonLd(): unknown | undefined;
   protected set _cachedJsonLd(value: unknown | undefined);
+  protected get _baseUrl(): URL | undefined;
   /**
   * The type URI of {@link Measure}: `http://www.ontology-of-units-of-measure.org/resource/om-2/Measure`.
   */
@@ -2548,6 +2551,7 @@ declare class InteractionPolicy {
   } | undefined;
   protected get _cachedJsonLd(): unknown | undefined;
   protected set _cachedJsonLd(value: unknown | undefined);
+  protected get _baseUrl(): URL | undefined;
   /**
   * The type URI of {@link InteractionPolicy}: `https://gotosocial.org/ns#InteractionPolicy`.
   */
@@ -2681,6 +2685,7 @@ declare class InteractionRule {
   } | undefined;
   protected get _cachedJsonLd(): unknown | undefined;
   protected set _cachedJsonLd(value: unknown | undefined);
+  protected get _baseUrl(): URL | undefined;
   /**
   * The type URI of {@link InteractionRule}: `https://gotosocial.org/ns#InteractionRule`.
   */
@@ -4089,6 +4094,7 @@ declare class DidService {
   } | undefined;
   protected get _cachedJsonLd(): unknown | undefined;
   protected set _cachedJsonLd(value: unknown | undefined);
+  protected get _baseUrl(): URL | undefined;
   /**
   * The type URI of {@link DidService}: `https://www.w3.org/ns/did#Service`.
   */
@@ -4262,6 +4268,7 @@ declare class DataIntegrityProof {
   } | undefined;
   protected get _cachedJsonLd(): unknown | undefined;
   protected set _cachedJsonLd(value: unknown | undefined);
+  protected get _baseUrl(): URL | undefined;
   /**
   * The type URI of {@link DataIntegrityProof}: `https://w3id.org/security#DataIntegrityProof`.
   */
@@ -4392,6 +4399,7 @@ declare class CryptographicKey {
   } | undefined;
   protected get _cachedJsonLd(): unknown | undefined;
   protected set _cachedJsonLd(value: unknown | undefined);
+  protected get _baseUrl(): URL | undefined;
   /**
   * The type URI of {@link CryptographicKey}: `https://w3id.org/security#Key`.
   */
@@ -4501,6 +4509,7 @@ declare class Multikey {
   } | undefined;
   protected get _cachedJsonLd(): unknown | undefined;
   protected set _cachedJsonLd(value: unknown | undefined);
+  protected get _baseUrl(): URL | undefined;
   /**
   * The type URI of {@link Multikey}: `https://w3id.org/security#Multikey`.
   */
@@ -4611,6 +4620,7 @@ declare class Intent {
   } | undefined;
   protected get _cachedJsonLd(): unknown | undefined;
   protected set _cachedJsonLd(value: unknown | undefined);
+  protected get _baseUrl(): URL | undefined;
   /**
   * The type URI of {@link Intent}: `https://w3id.org/valueflows/ont/vf#Intent`.
   */
@@ -8826,6 +8836,7 @@ declare class Endpoints {
   } | undefined;
   protected get _cachedJsonLd(): unknown | undefined;
   protected set _cachedJsonLd(value: unknown | undefined);
+  protected get _baseUrl(): URL | undefined;
   /**
   * The type URI of {@link Endpoints}: `https://www.w3.org/ns/activitystreams#Endpoints`.
   */
@@ -10153,6 +10164,7 @@ declare class Link {
   } | undefined;
   protected get _cachedJsonLd(): unknown | undefined;
   protected set _cachedJsonLd(value: unknown | undefined);
+  protected get _baseUrl(): URL | undefined;
   /**
   * The type URI of {@link Link}: `https://www.w3.org/ns/activitystreams#Link`.
   */
@@ -16381,6 +16393,7 @@ declare class Source {
   } | undefined;
   protected get _cachedJsonLd(): unknown | undefined;
   protected set _cachedJsonLd(value: unknown | undefined);
+  protected get _baseUrl(): URL | undefined;
   /**
   * The type URI of {@link Source}: `https://www.w3.org/ns/activitystreams#Source`.
   */
@@ -18479,6 +18492,21 @@ interface TraverseCollectionOptions {
 */
 declare function traverseCollection(collection: Collection, options?: TraverseCollectionOptions): AsyncIterable<Object$1 | Link>;
 //#endregion
+//#region src/preprocessors.d.ts
+/**
+* A property preprocessor that normalizes Link values to Image objects.
+*
+* When an `icon` or `image` property on a vocabulary object contains an
+* explicit ActivityStreams `Link` rather than an `Image`, this preprocessor
+* converts it into an `Image` by mapping `href` to `url`, copying
+* `mediaType`, `name`, `width`, and `height`, and discarding the rest.
+*
+* If the value is not a Link, or the Link has no `href`, it returns
+* `undefined` so the normal range decoder continues.
+* @since 2.3.0
+*/
+declare const normalizeLinkToImage: PropertyPreprocessor<Image>;
+//#endregion
 //#region src/type.d.ts
 /**
 * Returns the type URI of the given object.
@@ -18561,4 +18589,4 @@ declare function getTypeId(object: Object$1 | Link | null): URL | null;
 */
 declare function getTypeId(object: Object$1 | Link | null | undefined): URL | null | undefined;
 //#endregion
-export { $EntityType, Accept, Activity, Actor, ActorDiscoveryResult, ActorTypeName, Add, Announce, AnnounceAuthorization, AnnounceRequest, Application, Arrive, Article, Audio, Block, ChatMessage, Collection, CollectionPage, Create, CryptographicKey, DataIntegrityProof, Delete, DidService, Dislike, Document, type DocumentLoader, Emoji, EmojiReact, Endpoints, Event, Export, FediverseHandle, Flag, Follow, GetActorHandleOptions, type GetUserAgentOptions, Group, Hashtag, Ignore, Image, Intent, InteractionPolicy, InteractionRule, IntransitiveActivity, Invite, Join, LanguageString, Leave, Like, LikeAuthorization, LikeRequest, Link, Listen, LookupObjectOptions, Measure, Mention, Move, Multikey, NormalizeActorHandleOptions, Note, Object$1 as Object, ObjectLookupKind, Offer, OrderedCollection, OrderedCollectionPage, Organization, PUBLIC_COLLECTION, Page, Person, Place, Profile, PropertyValue, Proposal, Question, QuoteAuthorization, QuoteRequest, Read, Recipient, Reject, Relationship, type RemoteDocument, Remove, ReplyAuthorization, ReplyRequest, Service, Source, TentativeAccept, TentativeReject, Tombstone, Travel, TraverseCollectionOptions, Undo, Update, Video, View, getActorClassByTypeName, getActorHandle, getActorTypeName, getEntityTypeById, getTypeId, isActor, isEntityType, isFediverseHandle, lookupObject, normalizeActorHandle, parseFediverseHandle, toAcctUrl, traverseCollection };
+export { $EntityType, Accept, Activity, Actor, ActorDiscoveryResult, ActorTypeName, Add, Announce, AnnounceAuthorization, AnnounceRequest, Application, Arrive, Article, Audio, Block, ChatMessage, Collection, CollectionPage, Create, CryptographicKey, DataIntegrityProof, Delete, DidService, Dislike, Document, type DocumentLoader, Emoji, EmojiReact, Endpoints, Event, Export, FediverseHandle, Flag, Follow, GetActorHandleOptions, type GetUserAgentOptions, Group, Hashtag, Ignore, Image, Intent, InteractionPolicy, InteractionRule, IntransitiveActivity, Invite, Join, LanguageString, Leave, Like, LikeAuthorization, LikeRequest, Link, Listen, LookupObjectOptions, Measure, Mention, Move, Multikey, NormalizeActorHandleOptions, Note, Object$1 as Object, ObjectLookupKind, Offer, OrderedCollection, OrderedCollectionPage, Organization, PUBLIC_COLLECTION, Page, Person, Place, Profile, PropertyValue, Proposal, Question, QuoteAuthorization, QuoteRequest, Read, Recipient, Reject, Relationship, type RemoteDocument, Remove, ReplyAuthorization, ReplyRequest, Service, Source, TentativeAccept, TentativeReject, Tombstone, Travel, TraverseCollectionOptions, Undo, Update, Video, View, getActorClassByTypeName, getActorHandle, getActorTypeName, getEntityTypeById, getTypeId, isActor, isEntityType, isFediverseHandle, lookupObject, normalizeActorHandle, normalizeLinkToImage, parseFediverseHandle, toAcctUrl, traverseCollection };

package/dist/mod.d.ts

@@ -1,6 +1,6 @@
 /// <reference lib="esnext.temporal" />
 import { MeterProvider, Span, TracerProvider } from "@opentelemetry/api";
-import { Decimal, DocumentLoader, DocumentLoader as DocumentLoader$1, GetUserAgentOptions, GetUserAgentOptions as GetUserAgentOptions$1, LanguageString, LanguageString as LanguageString$1, RemoteDocument } from "@fedify/vocab-runtime";
+import { Decimal, DocumentLoader, DocumentLoader as DocumentLoader$1, GetUserAgentOptions, GetUserAgentOptions as GetUserAgentOptions$1, LanguageString, LanguageString as LanguageString$1, PropertyPreprocessor, RemoteDocument } from "@fedify/vocab-runtime";
 
 //#region src/vocab.d.ts
 /** Describes an object of any kind. The Object type serves as the base type for
@@ -22,6 +22,7 @@ declare class Object$1 {
   } | undefined;
   protected get _cachedJsonLd(): unknown | undefined;
   protected set _cachedJsonLd(value: unknown | undefined);
+  protected get _baseUrl(): URL | undefined;
   /**
   * The type URI of {@link Object}: `https://www.w3.org/ns/activitystreams#Object`.
   */
@@ -1918,6 +1919,7 @@ declare class PropertyValue {
   } | undefined;
   protected get _cachedJsonLd(): unknown | undefined;
   protected set _cachedJsonLd(value: unknown | undefined);
+  protected get _baseUrl(): URL | undefined;
   /**
   * The type URI of {@link PropertyValue}: `http://schema.org#PropertyValue`.
   */
@@ -2012,6 +2014,7 @@ declare class Measure {
   } | undefined;
   protected get _cachedJsonLd(): unknown | undefined;
   protected set _cachedJsonLd(value: unknown | undefined);
+  protected get _baseUrl(): URL | undefined;
   /**
   * The type URI of {@link Measure}: `http://www.ontology-of-units-of-measure.org/resource/om-2/Measure`.
   */
@@ -2548,6 +2551,7 @@ declare class InteractionPolicy {
   } | undefined;
   protected get _cachedJsonLd(): unknown | undefined;
   protected set _cachedJsonLd(value: unknown | undefined);
+  protected get _baseUrl(): URL | undefined;
   /**
   * The type URI of {@link InteractionPolicy}: `https://gotosocial.org/ns#InteractionPolicy`.
   */
@@ -2681,6 +2685,7 @@ declare class InteractionRule {
   } | undefined;
   protected get _cachedJsonLd(): unknown | undefined;
   protected set _cachedJsonLd(value: unknown | undefined);
+  protected get _baseUrl(): URL | undefined;
   /**
   * The type URI of {@link InteractionRule}: `https://gotosocial.org/ns#InteractionRule`.
   */
@@ -4089,6 +4094,7 @@ declare class DidService {
   } | undefined;
   protected get _cachedJsonLd(): unknown | undefined;
   protected set _cachedJsonLd(value: unknown | undefined);
+  protected get _baseUrl(): URL | undefined;
   /**
   * The type URI of {@link DidService}: `https://www.w3.org/ns/did#Service`.
   */
@@ -4262,6 +4268,7 @@ declare class DataIntegrityProof {
   } | undefined;
   protected get _cachedJsonLd(): unknown | undefined;
   protected set _cachedJsonLd(value: unknown | undefined);
+  protected get _baseUrl(): URL | undefined;
   /**
   * The type URI of {@link DataIntegrityProof}: `https://w3id.org/security#DataIntegrityProof`.
   */
@@ -4392,6 +4399,7 @@ declare class CryptographicKey {
   } | undefined;
   protected get _cachedJsonLd(): unknown | undefined;
   protected set _cachedJsonLd(value: unknown | undefined);
+  protected get _baseUrl(): URL | undefined;
   /**
   * The type URI of {@link CryptographicKey}: `https://w3id.org/security#Key`.
   */
@@ -4501,6 +4509,7 @@ declare class Multikey {
   } | undefined;
   protected get _cachedJsonLd(): unknown | undefined;
   protected set _cachedJsonLd(value: unknown | undefined);
+  protected get _baseUrl(): URL | undefined;
   /**
   * The type URI of {@link Multikey}: `https://w3id.org/security#Multikey`.
   */
@@ -4611,6 +4620,7 @@ declare class Intent {
   } | undefined;
   protected get _cachedJsonLd(): unknown | undefined;
   protected set _cachedJsonLd(value: unknown | undefined);
+  protected get _baseUrl(): URL | undefined;
   /**
   * The type URI of {@link Intent}: `https://w3id.org/valueflows/ont/vf#Intent`.
   */
@@ -8826,6 +8836,7 @@ declare class Endpoints {
   } | undefined;
   protected get _cachedJsonLd(): unknown | undefined;
   protected set _cachedJsonLd(value: unknown | undefined);
+  protected get _baseUrl(): URL | undefined;
   /**
   * The type URI of {@link Endpoints}: `https://www.w3.org/ns/activitystreams#Endpoints`.
   */
@@ -10153,6 +10164,7 @@ declare class Link {
   } | undefined;
   protected get _cachedJsonLd(): unknown | undefined;
   protected set _cachedJsonLd(value: unknown | undefined);
+  protected get _baseUrl(): URL | undefined;
   /**
   * The type URI of {@link Link}: `https://www.w3.org/ns/activitystreams#Link`.
   */
@@ -16381,6 +16393,7 @@ declare class Source {
   } | undefined;
   protected get _cachedJsonLd(): unknown | undefined;
   protected set _cachedJsonLd(value: unknown | undefined);
+  protected get _baseUrl(): URL | undefined;
   /**
   * The type URI of {@link Source}: `https://www.w3.org/ns/activitystreams#Source`.
   */
@@ -18479,6 +18492,21 @@ interface TraverseCollectionOptions {
 */
 declare function traverseCollection(collection: Collection, options?: TraverseCollectionOptions): AsyncIterable<Object$1 | Link>;
 //#endregion
+//#region src/preprocessors.d.ts
+/**
+* A property preprocessor that normalizes Link values to Image objects.
+*
+* When an `icon` or `image` property on a vocabulary object contains an
+* explicit ActivityStreams `Link` rather than an `Image`, this preprocessor
+* converts it into an `Image` by mapping `href` to `url`, copying
+* `mediaType`, `name`, `width`, and `height`, and discarding the rest.
+*
+* If the value is not a Link, or the Link has no `href`, it returns
+* `undefined` so the normal range decoder continues.
+* @since 2.3.0
+*/
+declare const normalizeLinkToImage: PropertyPreprocessor<Image>;
+//#endregion
 //#region src/type.d.ts
 /**
 * Returns the type URI of the given object.
@@ -18561,4 +18589,4 @@ declare function getTypeId(object: Object$1 | Link | null): URL | null;
 */
 declare function getTypeId(object: Object$1 | Link | null | undefined): URL | null | undefined;
 //#endregion
-export { $EntityType, Accept, Activity, Actor, ActorDiscoveryResult, ActorTypeName, Add, Announce, AnnounceAuthorization, AnnounceRequest, Application, Arrive, Article, Audio, Block, ChatMessage, Collection, CollectionPage, Create, CryptographicKey, DataIntegrityProof, Delete, DidService, Dislike, Document, type DocumentLoader, Emoji, EmojiReact, Endpoints, Event, Export, FediverseHandle, Flag, Follow, GetActorHandleOptions, type GetUserAgentOptions, Group, Hashtag, Ignore, Image, Intent, InteractionPolicy, InteractionRule, IntransitiveActivity, Invite, Join, LanguageString, Leave, Like, LikeAuthorization, LikeRequest, Link, Listen, LookupObjectOptions, Measure, Mention, Move, Multikey, NormalizeActorHandleOptions, Note, Object$1 as Object, ObjectLookupKind, Offer, OrderedCollection, OrderedCollectionPage, Organization, PUBLIC_COLLECTION, Page, Person, Place, Profile, PropertyValue, Proposal, Question, QuoteAuthorization, QuoteRequest, Read, Recipient, Reject, Relationship, type RemoteDocument, Remove, ReplyAuthorization, ReplyRequest, Service, Source, TentativeAccept, TentativeReject, Tombstone, Travel, TraverseCollectionOptions, Undo, Update, Video, View, getActorClassByTypeName, getActorHandle, getActorTypeName, getEntityTypeById, getTypeId, isActor, isEntityType, isFediverseHandle, lookupObject, normalizeActorHandle, parseFediverseHandle, toAcctUrl, traverseCollection };
+export { $EntityType, Accept, Activity, Actor, ActorDiscoveryResult, ActorTypeName, Add, Announce, AnnounceAuthorization, AnnounceRequest, Application, Arrive, Article, Audio, Block, ChatMessage, Collection, CollectionPage, Create, CryptographicKey, DataIntegrityProof, Delete, DidService, Dislike, Document, type DocumentLoader, Emoji, EmojiReact, Endpoints, Event, Export, FediverseHandle, Flag, Follow, GetActorHandleOptions, type GetUserAgentOptions, Group, Hashtag, Ignore, Image, Intent, InteractionPolicy, InteractionRule, IntransitiveActivity, Invite, Join, LanguageString, Leave, Like, LikeAuthorization, LikeRequest, Link, Listen, LookupObjectOptions, Measure, Mention, Move, Multikey, NormalizeActorHandleOptions, Note, Object$1 as Object, ObjectLookupKind, Offer, OrderedCollection, OrderedCollectionPage, Organization, PUBLIC_COLLECTION, Page, Person, Place, Profile, PropertyValue, Proposal, Question, QuoteAuthorization, QuoteRequest, Read, Recipient, Reject, Relationship, type RemoteDocument, Remove, ReplyAuthorization, ReplyRequest, Service, Source, TentativeAccept, TentativeReject, Tombstone, Travel, TraverseCollectionOptions, Undo, Update, Video, View, getActorClassByTypeName, getActorHandle, getActorTypeName, getEntityTypeById, getTypeId, isActor, isEntityType, isFediverseHandle, lookupObject, normalizeActorHandle, normalizeLinkToImage, parseFediverseHandle, toAcctUrl, traverseCollection };