# @embedpdf/plugin-link — ./contract/host Link [TypeAliasDeclaration] (from packages/plugin/link/src/contract.ts): export type Link = LinkNavItem; LinkActivateContext [InterfaceDeclaration] (from packages/plugin/link/src/contract.ts): export interface LinkActivateContext{ readonly activate?: PdfActionTree; readonly ref?: AnnotationRef; readonly page?: PageRef; readonly stage?: StageCapability; } LinkActivatedEvent [InterfaceDeclaration] (from packages/plugin/link/src/contract.ts): export interface LinkActivatedEvent{ readonly target: PdfLinkTarget; readonly activation: LinkActivation; } LinkActivation [TypeAliasDeclaration] (from packages/plugin/link/src/contract.ts): export type LinkActivation = |{ status: 'revealed'} |{ status: 'destination'; destination: PageDestination} |{ status: 'uri'; uri: string} |{ status: 'named'; name: string} |{ status: 'reported'; target: PdfLinkTarget} |{ status: 'dispatched'; dispatch: Promise} |{ status: 'none'} ; LinkCapability [InterfaceDeclaration] (from packages/plugin/link/src/contract.ts): export interface LinkCapability{ listLinks(page: PageRef | number): readonly Link[]; getLink(page: PageRef | number, linkId: string): Link | null; getLinkAt(page: PageRef | number, point: Point): Link | null; readAllLinks(options?: OperationOptions): Promise; ensureLoaded(page: PageRef | number, options?: OperationOptions): Promise; isLoaded(page: PageRef | number): boolean; getStatus(page: PageRef | number): ResourceStatus; resolve(target: PdfLinkTarget): LinkResolution; activate(target: PdfLinkTarget | Link, context?: LinkActivateContext): LinkActivation; activateAt( page: PageRef | number, point: Point, context?: LinkActivateContext, ): LinkActivation | null; getLabel(link: Link | PdfLinkTarget): string; readonly onActivated: EventHook; readonly onLoaded: EventHook; } LinkHostCapability [InterfaceDeclaration]: export interface LinkHostCapability extends LinkCapability{ isNavigationEngaged(): boolean; registerUriOpener(opener: UriOpener): Unsubscribe; } LinkLoadedEvent [InterfaceDeclaration] (from packages/plugin/link/src/contract.ts): export interface LinkLoadedEvent{ readonly page: PageRef; } LinkResolution [TypeAliasDeclaration] (from packages/plugin/link/src/contract.ts): export type LinkResolution = |{ kind: 'destination'; destination: PageDestination} |{ kind: 'uri'; uri: string} |{ kind: 'named'; name: string} |{ kind: 'reported'; target: PdfLinkTarget} ; LinkToken [VariableDeclaration]: LinkToken = createHostToken(PublicLinkToken) PageDestination [TypeAliasDeclaration] (from packages/engine/core/src/dto/PdfDestination.ts): export type PageDestination = |{ kind: 'xyz'; page: PageRef; x: number | null; y: number | null; zoom: number | null} |{ kind: 'fit'; page: PageRef} |{ kind: 'fitH'; page: PageRef; y: number | null} |{ kind: 'fitV'; page: PageRef; x: number | null} |{ kind: 'fitR'; page: PageRef; x: number; y: number; width: number; height: number} |{ kind: 'fitB'; page: PageRef} |{ kind: 'fitBH'; page: PageRef; y: number | null} |{ kind: 'fitBV'; page: PageRef; x: number | null} ; PdfLinkTarget [TypeAliasDeclaration] (from packages/engine/core/src/dto/PdfLinkTarget.ts): export type PdfLinkTarget = |{ kind: 'goto'; destination: Destination} |{ kind: 'uri'; uri: string} |{ kind: 'goto-remote'; file: string} |{ kind: 'launch'; path: string} |{ kind: 'javascript'} |{ kind: 'named'; name: string} |{ kind: 'unsupported'} ; UriOpener [TypeAliasDeclaration]: export type UriOpener = (uri: string) => boolean; resolveLinkTarget [FunctionDeclaration] (from packages/plugin/link/src/contract.ts): export function resolveLinkTarget( target: PdfLinkTarget, hasPage: (page: PageRef) => boolean, ): LinkResolution{ switch (target.kind){ case 'goto': return hasPage(target.destination.page) ?{ kind: 'destination', destination: target.destination} :{ kind: 'reported', target} ; case 'uri': return{ kind: 'uri', uri: target.uri} ; case 'named': return{ kind: 'named', name: target.name} ; default: return{ kind: 'reported', target} ; } }