| package org.jetbrains.dokka |
| |
| import com.google.inject.Singleton |
| |
| enum class RefKind { |
| Owner, |
| Member, |
| InheritedMember, |
| InheritedCompanionObjectMember, |
| Detail, |
| Link, |
| HiddenLink, |
| Extension, |
| Inheritor, |
| Superclass, |
| Override, |
| Annotation, |
| HiddenAnnotation, |
| Deprecation, |
| TopLevelPage, |
| Platform, |
| ExternalType, |
| Attribute, |
| AvailableSince |
| } |
| |
| data class DocumentationReference(val from: DocumentationNode, val to: DocumentationNode, val kind: RefKind) { |
| } |
| |
| class PendingDocumentationReference(val lazyNodeFrom: () -> DocumentationNode?, |
| val lazyNodeTo: () -> DocumentationNode?, |
| val kind: RefKind) { |
| fun resolve() { |
| val fromNode = lazyNodeFrom() |
| val toNode = lazyNodeTo() |
| if (fromNode != null && toNode != null) { |
| fromNode.addReferenceTo(toNode, kind) |
| } |
| } |
| } |
| |
| class NodeReferenceGraph() { |
| private val nodeMap = hashMapOf<String, DocumentationNode>() |
| val references = arrayListOf<PendingDocumentationReference>() |
| |
| fun register(signature: String, node: DocumentationNode) { |
| nodeMap.put(signature, node) |
| } |
| |
| fun link(fromNode: DocumentationNode, toSignature: String, kind: RefKind) { |
| references.add(PendingDocumentationReference({ -> fromNode}, { -> nodeMap[toSignature]}, kind)) |
| } |
| |
| fun link(fromSignature: String, toNode: DocumentationNode, kind: RefKind) { |
| references.add(PendingDocumentationReference({ -> nodeMap[fromSignature]}, { -> toNode}, kind)) |
| } |
| |
| fun link(fromSignature: String, toSignature: String, kind: RefKind) { |
| references.add(PendingDocumentationReference({ -> nodeMap[fromSignature]}, { -> nodeMap[toSignature]}, kind)) |
| } |
| |
| fun lookup(signature: String) = nodeMap[signature] |
| |
| fun lookupOrWarn(signature: String, logger: DokkaLogger): DocumentationNode? { |
| val result = nodeMap[signature] |
| if (result == null) { |
| logger.warn("Can't find node by signature $signature") |
| } |
| return result |
| } |
| |
| fun resolveReferences() { |
| references.forEach { it.resolve() } |
| } |
| } |
| |
| @Singleton |
| class PlatformNodeRegistry { |
| private val platformNodes = hashMapOf<String, DocumentationNode>() |
| |
| operator fun get(platform: String): DocumentationNode { |
| return platformNodes.getOrPut(platform) { |
| DocumentationNode(platform, Content.Empty, NodeKind.Platform) |
| } |
| } |
| } |