Functions
IR::PageMetadata	extractPageMetadata (const PageNode pn, const HrefResolver hrefResolver)
IR::QmlTypeData	extractQmlTypeData (const QmlTypeNode qcn, const HrefResolver hrefResolver)
IR::CollectionData	extractCollectionData (const CollectionNode cn, const HrefResolver hrefResolver)
static QList< IR::SignatureSpan >	buildTemplateDeclSpans (const RelaxedTemplateDeclaration *templateDecl)
IR::CppReferenceData	extractCppReferenceData (const Aggregate aggregate, const HrefResolver hrefResolver)
QList< IR::SectionIR >	extractSummarySections (const Aggregate aggregate, const HrefResolver hrefResolver)
QList< IR::SectionIR >	extractDetailSections (const Aggregate aggregate, const HrefResolver hrefResolver)
static QString	threadSafenessString (Node::ThreadSafeness ts)
IR::MemberIR	extractMemberIR (const Node node, const HrefResolver hrefResolver, const Node *relative, MemberExtractionLevel level)
static QList< IR::SignatureSpan >	buildTypeSpans (const QString &typeString)
static QList< IR::SignatureSpan >	buildExtraSpans (const Node *node, Section::Style style)
static QList< IR::SignatureSpan >	buildCppSynopsisSpans (const Node node, const HrefResolver hrefResolver, const Node *relative, Section::Style style)
static QList< IR::SignatureSpan >	buildQmlItemSpans (const Node node, const HrefResolver hrefResolver)
static QString	plainTextFromSpans (const QList< IR::SignatureSpan > &spans)
QList< IR::SignatureSpan >	buildSignatureSpans (const Node node, const HrefResolver hrefResolver, const Node *relative, Section::Style style)
static IR::AllMembersIR	extractQmlAllMembersIR (const QmlTypeNode qcn, const HrefResolver hrefResolver)
static IR::AllMembersIR	extractCppAllMembersIR (const Aggregate aggregate, const HrefResolver hrefResolver)
std::optional< IR::AllMembersIR >	extractAllMembersIR (const PageNode pn, const HrefResolver hrefResolver)
IR::NavigationData	extractNavigationData (const PageNode pn, const HrefResolver hrefResolver)
IR::MemberIR	extractMemberIR (const Node node, const HrefResolver hrefResolver, const Node *relative, MemberExtractionLevel level=MemberExtractionLevel::Summary)
QList< IR::SignatureSpan >	buildSignatureSpans (const Node node, const HrefResolver hrefResolver, const Node *relative, Section::Style style)

Function Documentation

◆ buildCppSynopsisSpans()

QList< IR::SignatureSpan > NodeExtractor::buildCppSynopsisSpans	(	const Node *	node,
		const HrefResolver *	hrefResolver,
		const Node *	relative,
		Section::Style	style )

static

Definition at line 1060 of file nodeextractor.cpp.

References Section::Accessors, Section::AllMembers, Parameters::at(), Class, Parameters::count(), Section::Details, Enum, Function, Node< _Tp >::isHeader(), Node< _Tp >::isProperty(), Node< _Tp >::isProxyNode(), Node< _Tp >::isQmlNode(), Node< _Tp >::isRelatedNonmember(), IR::Name, Namespace, Node< _Tp >::nodeType(), IR::Parameter, Node< _Tp >::parent(), Property, QmlProperty, IR::SignatureSpan::role, Struct, Section::Summary, IR::Text, TypeAlias, Typedef, Union, and Variable.

Here is the call graph for this function:

◆ buildExtraSpans()

QList< IR::SignatureSpan > NodeExtractor::buildExtraSpans	(	const Node *	node,
		Section::Style	style )

static

Definition at line 915 of file nodeextractor.cpp.

References IR::ExternalRef, IR::Extra, IR::SignatureSpan::role, and IR::Text.

◆ buildQmlItemSpans()

QList< IR::SignatureSpan > NodeExtractor::buildQmlItemSpans	(	const Node *	node,
		const HrefResolver *	hrefResolver )

static

Definition at line 1367 of file nodeextractor.cpp.

References Parameters::at(), Parameters::count(), Node< _Tp >::isFunction(), Node< _Tp >::isQmlProperty(), IR::Name, IR::Parameter, IR::SignatureSpan::role, and IR::Text.

Here is the call graph for this function:

◆ buildSignatureSpans() [1/2]

QList< IR::SignatureSpan > NodeExtractor::buildSignatureSpans	(	const Node *	node,
		const HrefResolver *	hrefResolver,
		const Node *	relative,
		Section::Style	style )

Build structured signature spans from Node data.

This function produces a QList of SignatureSpan values that carry semantic roles (Type, Name, Parameter, Extra, and so on) for each element of a member's synopsis. It parallels what CppCodeMarker's markedUpSynopsis() and markedUpQmlItem() produce as tagged strings, but outputs structured IR spans instead.

The style parameter controls level of detail: Summary includes virtual/override qualifiers, Details adds template declarations and parent prefixes, AllMembers uses a condensed format.

Definition at line 1464 of file nodeextractor.cpp.

◆ buildSignatureSpans() [2/2]

QList< IR::SignatureSpan > NodeExtractor::buildSignatureSpans	(	const Node *	node,
		const HrefResolver *	hrefResolver,
		const Node *	relative,
		Section::Style	style )

◆ buildTemplateDeclSpans()

QList< IR::SignatureSpan > NodeExtractor::buildTemplateDeclSpans ( const RelaxedTemplateDeclaration * templateDecl )

static

Definition at line 962 of file nodeextractor.cpp.

References IR::SignatureSpan::role, IR::TemplateDecl, and IR::Text.

◆ buildTypeSpans()

QList< IR::SignatureSpan > NodeExtractor::buildTypeSpans ( const QString & typeString )

static

Definition at line 880 of file nodeextractor.cpp.

References IR::SignatureSpan::role, IR::Text, and IR::Type.

◆ extractAllMembersIR()

std::optional< IR::AllMembersIR > NodeExtractor::extractAllMembersIR	(	const PageNode *	pn,
		const HrefResolver *	hrefResolver )

Extract all-members IR for a page node.

Dispatches to the QML or C++ extraction function based on the page type. Returns std::nullopt for page types that don't have member listing pages (generic pages, QML basic types) or when the listing would be empty.

Definition at line 1604 of file nodeextractor.cpp.

References Node< _Tp >::isAggregate(), Node< _Tp >::isClassNode(), Node< _Tp >::isNamespace(), and Node< _Tp >::isQmlType().

Referenced by TemplateGenerator::generateCppReferencePage(), and TemplateGenerator::generateQmlTypePage().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ extractCollectionData()

IR::CollectionData NodeExtractor::extractCollectionData	(	const CollectionNode *	cn,
		const HrefResolver *	hrefResolver )

Extract collection metadata from a CollectionNode.

Populates module identity, CMake/qmake build variables, technology preview state, and pre-sorted member listings. For C++ modules, members are categorized into separate namespace and class lists. For groups and QML modules, a single flat member list is produced.

All member lists are filtered through InclusionFilter (excluding internal entries) and exclude deprecated nodes, then sorted alphabetically by name (case-insensitive).

Definition at line 274 of file nodeextractor.cpp.

References CollectionNode::getMembers(), Node< _Tp >::isClassNode(), IR::CollectionData::isGroup, Node< _Tp >::isGroup(), IR::CollectionData::isModule, Node< _Tp >::isModule(), IR::CollectionData::isQmlModule, Node< _Tp >::isQmlModule(), Namespace, IR::CollectionData::noAutoList, and PageNode::noAutoList().

Here is the call graph for this function:

◆ extractCppAllMembersIR()

IR::AllMembersIR NodeExtractor::extractCppAllMembersIR	(	const Aggregate *	aggregate,
		const HrefResolver *	hrefResolver )

static

Extract a flat all-members listing for a C++ class or namespace.

Constructs a Sections object from the aggregate, extracts allMembersSection().members(), builds AllMemberEntry for each visible member, and returns an AllMembersIR with isQmlType=false.

Definition at line 1564 of file nodeextractor.cpp.

References Sections::Sections(), Sections::allMembersSection(), Section::isEmpty(), and IR::AllMembersIR::isQmlType.

Here is the call graph for this function:

◆ extractCppReferenceData()

IR::CppReferenceData NodeExtractor::extractCppReferenceData	(	const Aggregate *	aggregate,
		const HrefResolver *	hrefResolver )

Extract C++ reference page metadata from a class, namespace, or header.

Reads requisite table fields (header include, build-system snippets, status), inheritance hierarchies, template declarations, comparison operators, thread-safeness, and group associations. The result is a value-type struct that captures everything the template generator needs to render the requisites table and secondary sections without touching the Node tree at render time.

All three aggregate page types (ClassNode, NamespaceNode, HeaderNode) are handled, with ClassNode-specific sections gated on isClassNode().

Definition at line 382 of file nodeextractor.cpp.

References Node< _Tp >::comparisonCategory(), Node< _Tp >::doc(), QDocDatabase::groups(), Aggregate::hasObsoleteMembers(), IR::CppReferenceData::hasObsoleteMembers, Node< _Tp >::isClassNode(), IR::CppReferenceData::isHeader, Node< _Tp >::isHeader(), InclusionFilter::isIncluded(), IR::CppReferenceData::isInnerClass, IR::CppReferenceData::isNamespace, Node< _Tp >::isNamespace(), IR::CppReferenceData::isPartialNamespace, Module, Node< _Tp >::nodeNameLessThan(), Node< _Tp >::parent(), QDocDatabase::qdocDB(), IR::CppReferenceData::suppressInheritance, Node< _Tp >::templateDecl(), Node< _Tp >::threadSafeness(), and Node< _Tp >::UnspecifiedSafeness.

Here is the call graph for this function:

◆ extractDetailSections()

QList< IR::SectionIR > NodeExtractor::extractDetailSections	(	const Aggregate *	aggregate,
		const HrefResolver *	hrefResolver )

Build categorized detail sections for an aggregate node.

Iterates Sections::detailsSections() and extracts full member documentation including body content, anchor IDs, and metadata. SharedCommentNode groups share a single documentation body across their children, with each child getting its own anchorId and synopsis.

Definition at line 687 of file nodeextractor.cpp.

References Sections::Sections(), and Sections::detailsSections().

Here is the call graph for this function:

◆ extractMemberIR() [1/2]

IR::MemberIR NodeExtractor::extractMemberIR	(	const Node *	node,
		const HrefResolver *	hrefResolver,
		const Node *	relative,
		MemberExtractionLevel	level )

Build a MemberIR from a single Node.

Extracts identity, classification, and type-specific data from the node. FunctionNode provides signatures, parameters, and overload metadata. EnumNode provides scoped/unscoped signature and enum value listings. PropertyNode provides a qualified data type signature.

When level is MemberExtractionLevel::Detail, also populates detail documentation fields: anchorId, synopsis, since, threadSafety, comparisonCategory, noexcept metadata, body (via ContentBuilder), and alsoList.

Definition at line 767 of file nodeextractor.cpp.

References IR::MemberIR::access, Node< _Tp >::access(), Parameters::at(), Doc::body(), Doc::briefText(), Node< _Tp >::comparisonCategory(), comparisonCategoryAsString(), Parameters::count(), Detail, Section::Details, Node< _Tp >::doc(), Text::firstAtom(), IR::MemberIR::isAttached, IR::MemberIR::isConst, IR::MemberIR::isDefault, Node< _Tp >::isEnumType(), Node< _Tp >::isFunction(), IR::MemberIR::isNoexcept, IR::MemberIR::isPrimaryOverload, Node< _Tp >::isProperty(), Node< _Tp >::isQmlProperty(), IR::MemberIR::isReadOnly, IR::MemberIR::isRequired, IR::MemberIR::isSignal, IR::MemberIR::isSlot, IR::MemberIR::isStatic, Node< _Tp >::isTypedef(), IR::MemberIR::isVirtual, IR::MemberIR::nodeType, Node< _Tp >::nodeType(), IR::MemberIR::overloadNumber, Node< _Tp >::SignatureDefaultValues, Node< _Tp >::SignatureReturnType, IR::MemberIR::status, Node< _Tp >::status(), Section::Summary, and Variable.

Here is the call graph for this function:

◆ extractMemberIR() [2/2]

IR::MemberIR NodeExtractor::extractMemberIR	(	const Node *	node,
		const HrefResolver *	hrefResolver,
		const Node *	relative,
		MemberExtractionLevel	level = MemberExtractionLevel::Summary )

◆ extractNavigationData()

IR::NavigationData NodeExtractor::extractNavigationData	(	const PageNode *	pn,
		const HrefResolver *	hrefResolver )

Extract navigation metadata from a PageNode.

Reads navigation configuration values (homepage, landingpage, cppclassespage, qmltypespage) and the node's position in the documentation tree to produce a breadcrumb chain, sequential links (previous/next/start), and the configured TOC depth.

The breadcrumb chain follows page-type-specific logic ported from HtmlGenerator::generateNavigationBar(): static chain entries for API reference pages (class, QML type), a navigationParent() walk for generic pages with a 16-item circular reference cutoff, and a fallback to the first group page when no navigation parent exists.

Sequential links come from the node's pre-populated link map, set by QDocDatabase::updateNavigation() before generation runs.

Definition at line 1653 of file nodeextractor.cpp.

References IR::NavigationData::Current, QDocDatabase::getModuleNode(), Node< _Tp >::isClassNode(), Node< _Tp >::isQmlType(), PageNode::navigationParent(), QDocDatabase::qdocDB(), and IR::NavigationData::tocDepth.

Referenced by extractPageMetadata().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ extractPageMetadata()

IR::PageMetadata NodeExtractor::extractPageMetadata	(	const PageNode *	pn,
		const HrefResolver *	hrefResolver )

Extract page-level metadata from a PageNode into a value-type struct.

This function reads classification, identity, brief, and body fields from the given PageNode and returns them as an IR::PageMetadata value. Body content is populated via ContentBuilder, which transforms the atom chain into structured content blocks. Format-conditional atoms are skipped unconditionally since the template generator builds a format-agnostic IR.

For aggregate pages (classes, QML types, namespaces), member listings are extracted via the Sections infrastructure and stored as frozen SectionIR values.

The caller (TemplateGenerator) invokes this before passing the result to IR::Builder, ensuring Builder never includes PageNode or other Node subclass headers.

Definition at line 94 of file nodeextractor.cpp.

References IR::PageMetadata::access, Node< _Tp >::access(), Class, Node< _Tp >::doc(), extractNavigationData(), Text::firstAtom(), IR::PageMetadata::genus, Node< _Tp >::genus(), Group, Node< _Tp >::isAggregate(), Node< _Tp >::isClassNode(), Node< _Tp >::isCollectionNode(), Node< _Tp >::isHeader(), Node< _Tp >::isNamespace(), Node< _Tp >::isQmlType(), Module, Namespace, IR::PageMetadata::nodeType, Node< _Tp >::nodeType(), Page, QmlModule, QmlType, QmlValueType, IR::PageMetadata::status, Node< _Tp >::status(), Struct, and Union.

Referenced by TemplateGenerator::generateCollectionNode(), TemplateGenerator::generateCppReferencePage(), TemplateGenerator::generateGenericCollectionPage(), TemplateGenerator::generatePageNode(), and TemplateGenerator::generateQmlTypePage().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ extractQmlAllMembersIR()

IR::AllMembersIR NodeExtractor::extractQmlAllMembersIR	(	const QmlTypeNode *	qcn,
		const HrefResolver *	hrefResolver )

static

Extract a grouped all-members listing for a QML type.

Constructs a Sections object from the QmlTypeNode, extracts allMembersSection().classNodesList() to group members by originating QML type, and builds AllMemberEntry items with QML-specific hints and property group nesting.

Definition at line 1483 of file nodeextractor.cpp.

References Sections::allMembersSection(), Section::classNodesList(), Node< _Tp >::createContext(), and IR::AllMembersIR::isQmlType.

Here is the call graph for this function:

◆ extractQmlTypeData()

IR::QmlTypeData NodeExtractor::extractQmlTypeData	(	const QmlTypeNode *	qcn,
		const HrefResolver *	hrefResolver )

Extract QML type metadata from a QmlTypeNode.

Populates import statement, inheritance chain, inherited-by list, native C++ type link, and singleton/value-type flags. InclusionFilter is applied to match the legacy generator's visibility filtering.

Definition at line 190 of file nodeextractor.cpp.

References QmlTypeNode::classNode(), Node< _Tp >::createContext(), InclusionFilter::isIncluded(), Node< _Tp >::isQmlBasicType(), ClassNode::isQmlNativeType(), IR::QmlTypeData::isSingleton, QmlTypeNode::isSingleton(), IR::QmlTypeData::isValueType, QmlTypeNode::logicalModule(), QmlTypeNode::qmlBaseNode(), and QmlTypeNode::subclasses().

Here is the call graph for this function:

◆ extractSummarySections()

QList< IR::SectionIR > NodeExtractor::extractSummarySections	(	const Aggregate *	aggregate,
		const HrefResolver *	hrefResolver )

Build categorized summary sections for an aggregate node.

Delegates to the Sections class for member distribution, then extracts results into frozen SectionIR values. The section variant (C++ class, QML type, or generic) is chosen based on the aggregate's node type.

Definition at line 626 of file nodeextractor.cpp.

References Sections::Sections(), and Sections::summarySections().

Here is the call graph for this function:

◆ plainTextFromSpans()

QString NodeExtractor::plainTextFromSpans ( const QList< IR::SignatureSpan > & spans )

static

Definition at line 1442 of file nodeextractor.cpp.

◆ threadSafenessString()

QString NodeExtractor::threadSafenessString ( Node::ThreadSafeness ts )

static

Definition at line 741 of file nodeextractor.cpp.

Functions

Function Documentation

◆ buildCppSynopsisSpans()

◆ buildExtraSpans()

◆ buildQmlItemSpans()

◆ buildSignatureSpans() [1/2]

◆ buildSignatureSpans() [2/2]

◆ buildTemplateDeclSpans()

◆ buildTypeSpans()

◆ extractAllMembersIR()

◆ extractCollectionData()

◆ extractCppAllMembersIR()

◆ extractCppReferenceData()

◆ extractDetailSections()

◆ extractMemberIR() [1/2]

◆ extractMemberIR() [2/2]

◆ extractNavigationData()

◆ extractPageMetadata()

◆ extractQmlAllMembersIR()

◆ extractQmlTypeData()

◆ extractSummarySections()

◆ plainTextFromSpans()

◆ threadSafenessString()