1 files changed, 206 insertions, 0 deletions
diff --git a/src/qdoc/qdoc/sections.h b/src/qdoc/qdoc/sections.h
new file mode 100644
index 000000000..70c73a91c
--- /dev/null
+++ b/src/qdoc/qdoc/sections.h
@@ -0,0 +1,206 @@
+// Copyright (C) 2021 The Qt Company Ltd.
+// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only WITH Qt-GPL-exception-1.0
+
+#ifndef SECTIONS_H
+#define SECTIONS_H
+
+#include "node.h"
+
+QT_BEGIN_NAMESPACE
+
+class Aggregate;
+
+typedef std::pair<const QmlTypeNode *, NodeVector> ClassNodes;
+typedef QList<ClassNodes> ClassNodesList;
+
+class Section
+{
+public:
+    enum Style { Summary, Details, AllMembers, Accessors };
+
+public:
+    Section(
+        QString title, QString singular, QString plural,
+        QString divclass, Style style
+    ) : m_title{title}, m_singular{singular}, m_plural{plural},
+        m_divClass{divclass}, m_style{style}
+    {}
+
+    ~Section();
+
+    void insert(Node *node);
+    bool insertReimplementedMember(Node *node);
+
+    void appendMember(Node *node) { m_members.append(node); }
+
+    void clear();
+    void reduce();
+    [[nodiscard]] bool isEmpty() const
+    {
+        return (m_members.isEmpty() && m_inheritedMembers.isEmpty()
+                && m_reimplementedMemberMap.isEmpty() && m_classNodesList.isEmpty());
+    }
+
+    [[nodiscard]] Style style() const { return m_style; }
+    [[nodiscard]] const QString &title() const { return m_title; }
+    [[nodiscard]] const QString &divClass() const { return m_divClass; }
+    [[nodiscard]] const QString &singular() const { return m_singular; }
+    [[nodiscard]] const QString &plural() const { return m_plural; }
+    [[nodiscard]] const NodeVector &members() const { return m_members; }
+    [[nodiscard]] const NodeVector &reimplementedMembers() const { return m_reimplementedMembers; }
+    [[nodiscard]] const QList<std::pair<Aggregate *, int>> &inheritedMembers() const
+    {
+        return m_inheritedMembers;
+    }
+    ClassNodesList &classNodesList() { return m_classNodesList; }
+    [[nodiscard]] const NodeVector &obsoleteMembers() const { return m_obsoleteMembers; }
+    void appendMembers(const NodeVector &nv) { m_members.append(nv); }
+    [[nodiscard]] const Aggregate *aggregate() const { return m_aggregate; }
+    void setAggregate(Aggregate *t) { m_aggregate = t; }
+
+private:
+    QString m_title {};
+    QString m_singular {};
+    QString m_plural {};
+    QString m_divClass {};
+    Style m_style {};
+
+    Aggregate *m_aggregate { nullptr };
+    NodeVector m_members {};
+    NodeVector m_obsoleteMembers {};
+    NodeVector m_reimplementedMembers {};
+    QList<std::pair<Aggregate *, int>> m_inheritedMembers {};
+    ClassNodesList m_classNodesList {};
+
+    QMultiMap<QString, Node *> m_reimplementedMemberMap {};
+};
+
+typedef QList<Section> SectionVector;
+typedef QList<const Section *> SectionPtrVector;
+
+class Sections
+{
+public:
+    enum VectorIndex {
+        PublicTypes = 0,
+        DetailsMemberTypes = 0,
+        SinceNamespaces = 0,
+        StdNamespaces = 0,
+        QmlProperties = 0,
+        Properties = 1,
+        DetailsProperties = 1,
+        SinceClasses = 1,
+        StdClasses = 1,
+        QmlAttachedProperties = 1,
+        PublicFunctions = 2,
+        DetailsMemberFunctions = 2,
+        SinceMemberFunctions = 2,
+        StdTypes = 2,
+        QmlSignals = 2,
+        PublicSlots = 3,
+        DetailsMemberVariables = 3,
+        SinceNamespaceFunctions = 3,
+        StdVariables = 3,
+        QmlSignalHandlers = 3,
+        Signals = 4,
+        SinceGlobalFunctions = 4,
+        DetailsRelatedNonmembers = 4,
+        StdStaticVariables = 4,
+        QmlAttachedSignals = 4,
+        PublicVariables = 5,
+        SinceMacros = 5,
+        DetailsMacros = 5,
+        StdFunctions = 5,
+        QmlMethods = 5,
+        StaticPublicMembers = 6,
+        SinceEnumTypes = 6,
+        StdMacros = 6,
+        QmlAttachedMethods = 6,
+        SinceEnumValues = 7,
+        ProtectedTypes = 7,
+        SinceTypeAliases = 8,
+        ProtectedFunctions = 8,
+        SinceProperties = 9,
+        ProtectedSlots = 9,
+        SinceVariables = 10,
+        ProtectedVariables = 10,
+        SinceQmlTypes = 11,
+        StaticProtectedMembers = 11,
+        SinceQmlProperties = 12,
+        PrivateTypes = 12,
+        SinceQmlSignals = 13,
+        PrivateFunctions = 13,
+        SinceQmlSignalHandlers = 14,
+        PrivateSlots = 14,
+        SinceQmlMethods = 15,
+        StaticPrivateMembers = 15,
+        RelatedNonmembers = 16,
+        Macros = 17
+    };
+
+    explicit Sections(Aggregate *aggregate);
+    explicit Sections(const NodeMultiMap &nsmap);
+    ~Sections();
+
+    void clear(SectionVector &v);
+    void reduce(SectionVector &v);
+    void buildStdRefPageSections();
+    void buildStdCppClassRefPageSections();
+    void buildStdQmlTypeRefPageSections();
+
+    bool hasObsoleteMembers(SectionPtrVector *summary_spv, SectionPtrVector *details_spv) const;
+
+    static Section &allMembersSection() { return s_allMembers[0]; }
+    SectionVector &sinceSections() { return s_sinceSections; }
+    SectionVector &stdSummarySections() { return s_stdSummarySections; }
+    SectionVector &stdDetailsSections() { return s_stdDetailsSections; }
+    SectionVector &stdCppClassSummarySections() { return s_stdCppClassSummarySections; }
+    SectionVector &stdCppClassDetailsSections() { return s_stdCppClassDetailsSections; }
+    SectionVector &stdQmlTypeSummarySections() { return s_stdQmlTypeSummarySections; }
+    SectionVector &stdQmlTypeDetailsSections() { return s_stdQmlTypeDetailsSections; }
+
+    [[nodiscard]] const SectionVector &stdSummarySections() const { return s_stdSummarySections; }
+    [[nodiscard]] const SectionVector &stdDetailsSections() const { return s_stdDetailsSections; }
+    [[nodiscard]] const SectionVector &stdCppClassSummarySections() const
+    {
+        return s_stdCppClassSummarySections;
+    }
+    [[nodiscard]] const SectionVector &stdCppClassDetailsSections() const
+    {
+        return s_stdCppClassDetailsSections;
+    }
+    [[nodiscard]] const SectionVector &stdQmlTypeSummarySections() const
+    {
+        return s_stdQmlTypeSummarySections;
+    }
+    [[nodiscard]] const SectionVector &stdQmlTypeDetailsSections() const
+    {
+        return s_stdQmlTypeDetailsSections;
+    }
+
+    [[nodiscard]] Aggregate *aggregate() const { return m_aggregate; }
+
+private:
+    void stdRefPageSwitch(SectionVector &v, Node *n, Node *t = nullptr);
+    void distributeNodeInSummaryVector(SectionVector &sv, Node *n);
+    void distributeNodeInDetailsVector(SectionVector &dv, Node *n);
+    void distributeQmlNodeInDetailsVector(SectionVector &dv, Node *n);
+    void distributeQmlNodeInSummaryVector(SectionVector &sv, Node *n, bool sharing = false);
+    void initAggregate(SectionVector &v, Aggregate *aggregate);
+
+private:
+    Aggregate *m_aggregate { nullptr };
+
+    static SectionVector s_stdSummarySections;
+    static SectionVector s_stdDetailsSections;
+    static SectionVector s_stdCppClassSummarySections;
+    static SectionVector s_stdCppClassDetailsSections;
+    static SectionVector s_stdQmlTypeSummarySections;
+    static SectionVector s_stdQmlTypeDetailsSections;
+    static SectionVector s_sinceSections;
+    static SectionVector s_allMembers;
+};
+
+QT_END_NAMESPACE
+
+#endif