document.h

Go to the documentation of this file.

// Copyright (C) 2025 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only WITH Qt-GPL-exception-1.0
 
#ifndef QDOC_IR_DOCUMENT_H
#define QDOC_IR_DOCUMENT_H
 
#include "contentblock.h"
#include "member.h"
 
#include "qdoc/access.h"
#include "qdoc/genustypes.h"
#include "qdoc/status.h"
 
#include <QJsonObject>
#include <QList>
#include <QString>
 
#include <optional>
 
QT_BEGIN_NAMESPACE
 
namespace IR {
 
struct QmlTypeInfo
{
    QString importStatement;
    bool isSingleton { false };
    bool isValueType { false };
 
    struct InheritsInfo {
        QString name;
        QString href;
        QString moduleName;
    };
    std::optional<InheritsInfo> inherits;
 
    struct InheritedByEntry {
        QString name;
        QString href;
    };
    QList<InheritedByEntry> inheritedBy;
 
    struct NativeTypeInfo {
        QString name;
        QString href;
    };
    std::optional<NativeTypeInfo> nativeType;
 
    [[nodiscard]] QJsonObject toJson() const;
};
 
struct CollectionInfo
{
    QString logicalModuleName;
    QString logicalModuleVersion;
    QString qtVariable;
    QString cmakePackage;
    QString cmakeComponent;
    QString cmakeTargetItem;
    QString state;
 
    bool isModule { false };
    bool isQmlModule { false };
    bool isGroup { false };
    bool noAutoList { false };
 
    struct MemberEntry {
        QString name;
        QString href;
        QString brief;
    };
 
    QList<MemberEntry> namespaces;
    QList<MemberEntry> classes;
    QList<MemberEntry> members;
 
    [[nodiscard]] QJsonObject toJson() const;
};
 
struct Document
{
    // Classification
    NodeType nodeType { NodeType::NoType };
    Genus genus { Genus::DontCare };
    Status status { Status::Active };
    Access access { Access::Public };
 
    // Identity
    QString title;              // Page title
    QString fullTitle;          // Full qualified title
    QString url;                // Output file URL (relative)
    QString since;              // Version introduced (e.g., "6.8")
    QString deprecatedSince;    // Version deprecated (e.g., "6.5")
    QString brief;              // Brief description
 
    // Content
    QList<ContentBlock> body;
    QJsonObject contentJson;
 
    // Members (for aggregate pages)
    QList<SectionIR> summarySections;
    QList<SectionIR> detailSections;
 
    // QML type metadata (populated only for QML type pages)
    std::optional<QmlTypeInfo> qmlTypeInfo;
 
    // Collection metadata (populated for module, QML module, and group pages)
    std::optional<CollectionInfo> collectionInfo;
 
    // Members sub-page URL (set when a members listing page is generated)
    QString membersPageUrl;
 
    QJsonObject toJson() const;
};
 
} // namespace IR
 
QT_END_NAMESPACE
 
#endif // QDOC_IR_DOCUMENT_H