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)
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 QString	stripCodeMarkerTags (const QString &marked)
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::MemberIR	extractMemberIR (const Node node, const HrefResolver hrefResolver, const Node *relative, MemberExtractionLevel level=MemberExtractionLevel::Summary)

Function Documentation

◆ 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 716 of file nodeextractor.cpp.

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

Referenced by 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 251 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 675 of file nodeextractor.cpp.

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

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 384 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 464 of file nodeextractor.cpp.

References IR::MemberIR::access, Node< _Tp >::access(), Parameters::at(), Doc::body(), Doc::briefText(), Node< _Tp >::comparisonCategory(), comparisonCategoryAsString(), Parameters::count(), Detail, 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(), 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 )

◆ 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 85 of file nodeextractor.cpp.

References IR::PageMetadata::access, Node< _Tp >::access(), Class, Node< _Tp >::doc(), Text::firstAtom(), IR::PageMetadata::genus, Node< _Tp >::genus(), Group, Node< _Tp >::isAggregate(), Node< _Tp >::isCollectionNode(), 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::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 593 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 167 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 323 of file nodeextractor.cpp.

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

Here is the call graph for this function:

◆ stripCodeMarkerTags()

QString NodeExtractor::stripCodeMarkerTags ( const QString & marked )

static

Definition at line 574 of file nodeextractor.cpp.

◆ threadSafenessString()

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

static

Definition at line 438 of file nodeextractor.cpp.

Functions

Function Documentation

◆ extractAllMembersIR()

◆ extractCollectionData()

◆ extractCppAllMembersIR()

◆ extractDetailSections()

◆ extractMemberIR() [1/2]

◆ extractMemberIR() [2/2]

◆ extractPageMetadata()

◆ extractQmlAllMembersIR()

◆ extractQmlTypeData()

◆ extractSummarySections()

◆ stripCodeMarkerTags()

◆ threadSafenessString()