Cleanup unused assets

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "KomplexHubPlugin/3rdparty/qtkeychain"]
+	path = KomplexHubPlugin/3rdparty/qtkeychain
+	url = https://github.com/frankosterfeld/qtkeychain.git

AI_ASSETS

@@ -0,0 +1,79 @@
+;This file is used to denote what files have generative content
+;Format: {file, class, model/version, ["message"]}
+
+;Kero
+{
+    images/kero/kero_build_1.png,
+    placeholders,
+    chatgpt5
+}
+{
+    images/kero/kero_build_2.png,
+    placeholders,
+    chatgpt5
+}
+{
+    images/kero/kero_build_3.png,
+    placeholders,
+    chatgpt5
+}
+{
+    images/kero/kero_build_4.png,
+    placeholders,
+    chatgpt5
+}
+{
+    images/kero/kero_build_error.png,
+    placeholders,
+    chatgpt5
+}
+{
+    images/kero/kero_choice.png,
+    placeholders,
+    chatgpt5
+}
+{
+    images/kero/kero_hello.png,
+    placeholders,
+    chatgpt5
+}
+{
+    images/kero/kero_login.png,
+    placeholders,
+    chatgpt5
+}
+{
+    images/kero/kero_no_results.png,
+    placeholders,
+    chatgpt5
+}
+{
+    images/kero/kero_run_1.png,
+    placeholders,
+    chatgpt5
+}
+{
+    images/kero/kero_run_2.png,
+    placeholders,
+    chatgpt5
+}
+{
+    images/kero/kero_run_3.png,
+    placeholders,
+    chatgpt5
+}
+{
+    images/kero/kero_run_4.png,
+    placeholders,
+    chatgpt5
+}
+{
+    images/kero/kero_warning.png,
+    placeholders,
+    chatgpt5
+}
+{
+    images/kero/kero_success.png,
+    placeholders,
+    chatgpt5
+}

CMakeLists.txt

@@ -20,13 +20,25 @@ set(QML_IMPORT_PATH ${QT_QML_OUTPUT_DIRECTORY}
     FORCE
 )
 
-find_package(Qt6 6.8 REQUIRED COMPONENTS Core Gui Widgets Qml Quick QuickControls2 QuickTimeline ShaderTools Concurrent)
+find_package(
+  Qt6 6.8
+    REQUIRED COMPONENTS
+      Core
+      Gui
+      Widgets
+      Qml
+      Quick
+      QuickControls2
+      QuickTimeline
+      ShaderTools
+      Concurrent
+)
+
 qt_standard_project_setup()
 
 qt_add_executable(${CMAKE_PROJECT_NAME}
-  README.md
-  LICENSE
 )
+
 qt_add_resources(${CMAKE_PROJECT_NAME} "configuration"
   PREFIX "/"
   FILES
@@ -86,13 +98,13 @@ qt_add_resources(${CMAKE_PROJECT_NAME} "app_images"
     "images/kero/kero_run_4.png"
     "images/kero/kero_success.png"
     "images/kero/kero_warning.png"
-    )
+)
 
-  target_compile_definitions(
+target_compile_definitions(
   ${CMAKE_PROJECT_NAME}
   PUBLIC
     KOMPLEX_LOCAL_DEV
-  )
+)
 
 include(qds)
 

Generated/Quick3DAssets.txt

@@ -1 +0,0 @@
-Imported 3D assets and components imported from bundles will be created in this folder.

KomplexHubContent/CMakeLists.txt

@@ -18,6 +18,9 @@ qt6_add_qml_module(KomplexHubContent
         "pages/UserProfilePage.qml"
         "pages/WallpaperSettingsPage.qml"
         "pages/VideoSearchPage.qml"
+        QML_FILES pages/FeaturedVideosPage.qml
+        QML_FILES pages/FeaturedPacksPage.qml
+        QML_FILES pages/FeaturedImagesPage.qml
 )
 
 

KomplexHubContent/pages/FeaturedImagesPage.qml

@@ -0,0 +1,129 @@
+import QtQuick
+import QtQuick.Controls
+import QtQuick.Layouts
+
+import KomplexHub
+import KomplexHub.Controls
+import KomplexHub.Kero
+import KomplexHubPlugin
+
+Rectangle
+{
+    id: rootItem
+
+    readonly property bool searchable: false
+    property bool popup: false
+    property int resultWidth: 256
+    property int resultHeight: 245
+
+    color: palette.base
+
+    FeaturedImagesModel
+    {
+        id: imagesModel
+        resultsPerPage: paginator.resultsPerPage
+        // windowSize: 80
+    }
+
+    PaginatorGrid
+    {
+        id: paginator
+        anchors.fill: parent
+        model: imagesModel
+        loading: imagesModel.state === FeaturedImagesModel.Loading
+        visible: opacity > 0.01
+
+        delegate: ItemDelegate
+        {
+            id: resultDelegate
+
+            width: resultWidth
+            height: resultHeight
+
+            required property string uuid
+            required property string author
+            required property string authorId
+            required property string authorUrl
+            required property string thumbnail
+            required property int index
+
+            SearchResultItem
+            {
+                anchors.fill: parent
+                author: parent.author
+                description: qsTr("No description available")
+                thumbnail: parent.thumbnail
+                uuid: parent.uuid
+                pexels: true
+                selected: paginator.currentIndex === parent.index
+
+                onTriggered: () => paginator.currentIndex = parent.index
+
+                onViewMoreTriggered: () =>
+                {
+                    showVideoPopup(parent.index)
+                }
+            }
+        }
+    }
+
+    Rectangle
+    {
+        id: popupContainer
+        anchors.fill: parent
+        opacity: 0
+        visible: opacity > 0.01
+        color: palette.base
+
+        ImageView
+        {
+            id: imageDetailsPopup
+            anchors.fill: parent
+            opacity: 0
+
+            Behavior on opacity
+            {
+                NumberAnimation
+                {
+                    duration: 250
+                }
+            }
+        }
+
+        Behavior on opacity
+        {
+            NumberAnimation
+            {
+                duration: 250
+            }
+        }
+    }
+
+    Component.onCompleted: () =>
+    {
+        imagesModel.nextPage()
+    }
+
+    function showVideoPopup(index)
+    {
+        imagesModel.setItem(index)
+        imageDetailsPopup.author = searchModel.data(searchModel.index(index,0), VideoSearchModel.AuthorRole)
+        imageDetailsPopup.authorUrl = searchModel.data(searchModel.index(index,0), VideoSearchModel.AuthorUrlRole)
+        imageDetailsPopup.uuid = searchModel.data(searchModel.index(index,0), VideoSearchModel.UuidRole)
+        imageDetailsPopup.thumbnail = searchModel.data(searchModel.index(index,0), VideoSearchModel.ThumbnailRole)
+        imageDetailsPopup.modelIndex = index
+        imageDetailsPopup.model = searchModel.itemModel
+        imageDetailsPopup.opacity = 1
+        paginator.opacity = 0
+        popupContainer.opacity = 1
+        rootItem.popup = true
+    }
+
+    function closePopup()
+    {
+        imageDetailsPopup.opacity = 0
+        popupContainer.opacity = 0
+        paginator.opacity = 1
+        rootItem.popup = false
+    }
+}

KomplexHubContent/pages/FeaturedPacksPage.qml

@@ -0,0 +1,129 @@
+import QtQuick
+import QtQuick.Controls
+import QtQuick.Layouts
+
+import KomplexHub
+import KomplexHub.Controls
+import KomplexHub.Kero
+import KomplexHubPlugin
+
+Rectangle
+{
+    id: rootItem
+
+    readonly property bool searchable: false
+    property bool popup: false
+    property int resultWidth: 256
+    property int resultHeight: 245
+
+    color: palette.base
+
+    FeaturedPacksModel
+    {
+        id: packsModel
+        resultsPerPage: paginator.resultsPerPage
+        // windowSize: 80
+    }
+
+    PaginatorGrid
+    {
+        id: paginator
+        anchors.fill: parent
+        model: packsModel
+        loading: packsModel.state === FeaturedPacksModel.Loading
+        visible: opacity > 0.01
+
+        delegate: ItemDelegate
+        {
+            id: resultDelegate
+
+            width: resultWidth
+            height: resultHeight
+
+            required property string uuid
+            required property string author
+            required property string authorId
+            required property string authorUrl
+            required property string thumbnail
+            required property int index
+
+            SearchResultItem
+            {
+                anchors.fill: parent
+                author: parent.author
+                description: qsTr("No description available")
+                thumbnail: parent.thumbnail
+                uuid: parent.uuid
+                pexels: true
+                selected: paginator.currentIndex === parent.index
+
+                onTriggered: () => paginator.currentIndex = parent.index
+
+                onViewMoreTriggered: () =>
+                {
+                    showVideoPopup(parent.index)
+                }
+            }
+        }
+    }
+
+    Rectangle
+    {
+        id: popupContainer
+        anchors.fill: parent
+        opacity: 0
+        visible: opacity > 0.01
+        color: palette.base
+
+        PackView
+        {
+            id: packDetailsPopup
+            anchors.fill: parent
+            opacity: 0
+
+            Behavior on opacity
+            {
+                NumberAnimation
+                {
+                    duration: 250
+                }
+            }
+        }
+
+        Behavior on opacity
+        {
+            NumberAnimation
+            {
+                duration: 250
+            }
+        }
+    }
+
+    Component.onCompleted: () =>
+    {
+        packsModel.nextPage()
+    }
+
+    function showVideoPopup(index)
+    {
+        packsModel.setItem(index)
+        packDetailsPopup.author = searchModel.data(searchModel.index(index,0), VideoSearchModel.AuthorRole)
+        packDetailsPopup.authorUrl = searchModel.data(searchModel.index(index,0), VideoSearchModel.AuthorUrlRole)
+        packDetailsPopup.uuid = searchModel.data(searchModel.index(index,0), VideoSearchModel.UuidRole)
+        packDetailsPopup.thumbnail = searchModel.data(searchModel.index(index,0), VideoSearchModel.ThumbnailRole)
+        packDetailsPopup.modelIndex = index
+        packDetailsPopup.model = searchModel.itemModel
+        packDetailsPopup.opacity = 1
+        paginator.opacity = 0
+        popupContainer.opacity = 1
+        rootItem.popup = true
+    }
+
+    function closePopup()
+    {
+        packDetailsPopup.opacity = 0
+        popupContainer.opacity = 0
+        paginator.opacity = 1
+        rootItem.popup = false
+    }
+}

KomplexHubContent/pages/FeaturedVideosPage.qml

@@ -0,0 +1,129 @@
+import QtQuick
+import QtQuick.Controls
+import QtQuick.Layouts
+
+import KomplexHub
+import KomplexHub.Controls
+import KomplexHub.Kero
+import KomplexHubPlugin
+
+Rectangle
+{
+    id: rootItem
+
+    readonly property bool searchable: false
+    property bool popup: false
+    property int resultWidth: 256
+    property int resultHeight: 245
+
+    color: palette.base
+
+    FeaturedVideosModel
+    {
+        id: videosModel
+        resultsPerPage: paginator.resultsPerPage
+        windowSize: 80
+    }
+
+    PaginatorGrid
+    {
+        id: paginator
+        anchors.fill: parent
+        model: videosModel
+        loading: videosModel.state === FeaturedVideosModel.Loading
+        visible: opacity > 0.01
+
+        delegate: ItemDelegate
+        {
+            id: resultDelegate
+
+            width: resultWidth
+            height: resultHeight
+
+            required property string uuid
+            required property string author
+            required property string authorId
+            required property string authorUrl
+            required property string thumbnail
+            required property int index
+
+            SearchResultItem
+            {
+                anchors.fill: parent
+                author: parent.author
+                description: qsTr("No description available")
+                thumbnail: parent.thumbnail
+                uuid: parent.uuid
+                pexels: true
+                selected: paginator.currentIndex === parent.index
+
+                onTriggered: () => paginator.currentIndex = parent.index
+
+                onViewMoreTriggered: () =>
+                {
+                    showVideoPopup(parent.index)
+                }
+            }
+        }
+    }
+
+    Rectangle
+    {
+        id: popupContainer
+        anchors.fill: parent
+        opacity: 0
+        visible: opacity > 0.01
+        color: palette.base
+
+        VideoView
+        {
+            id: videoDetailsPopup
+            anchors.fill: parent
+            opacity: 0
+
+            Behavior on opacity
+            {
+                NumberAnimation
+                {
+                    duration: 250
+                }
+            }
+        }
+
+        Behavior on opacity
+        {
+            NumberAnimation
+            {
+                duration: 250
+            }
+        }
+    }
+
+    Component.onCompleted: () =>
+    {
+        videosModel.nextPage()
+    }
+
+    function showVideoPopup(index)
+    {
+        videosModel.setItem(index)
+        videoDetailsPopup.author = searchModel.data(searchModel.index(index,0), VideoSearchModel.AuthorRole)
+        videoDetailsPopup.authorUrl = searchModel.data(searchModel.index(index,0), VideoSearchModel.AuthorUrlRole)
+        videoDetailsPopup.uuid = searchModel.data(searchModel.index(index,0), VideoSearchModel.UuidRole)
+        videoDetailsPopup.thumbnail = searchModel.data(searchModel.index(index,0), VideoSearchModel.ThumbnailRole)
+        videoDetailsPopup.modelIndex = index
+        videoDetailsPopup.model = searchModel.itemModel
+        videoDetailsPopup.opacity = 1
+        paginator.opacity = 0
+        popupContainer.opacity = 1
+        rootItem.popup = true
+    }
+
+    function closePopup()
+    {
+        videoDetailsPopup.opacity = 0
+        popupContainer.opacity = 0
+        paginator.opacity = 1
+        rootItem.popup = false
+    }
+}

KomplexHubContent/pages/HomePage.qml

@@ -116,6 +116,11 @@ Item
                         }
                     }
                 }
+
+                onViewMoreTriggered: () =>
+                {
+                    showFeaturedPacksPage()
+                }
             }
 
             Text
@@ -168,6 +173,11 @@ Item
                         }
                     }
                 }
+
+                onViewMoreTriggered: () =>
+                {
+                    showFeaturedImagesPage()
+                }
             }
 
             Text
@@ -215,6 +225,11 @@ Item
                         onViewMoreTriggered:() => showVideoPopup(parent.index)
                     }
                 }
+
+                onViewMoreTriggered: () =>
+                {
+                    showFeaturedVideosPage()
+                }
             }
 
             /* spacer */
@@ -301,6 +316,51 @@ Item
         }
     }
 
+    FeaturedVideosPage
+    {
+        id: featuredVideosPage
+        anchors.fill: parent
+        opacity: 0
+        visible: opacity > 0.01
+
+        Behavior on opacity {
+            NumberAnimation
+            {
+                duration: 250
+            }
+        }
+    }
+
+    FeaturedPacksPage
+    {
+        id: featuredPacksPage
+        anchors.fill: parent
+        opacity: 0
+        visible: opacity > 0.01
+
+        Behavior on opacity {
+            NumberAnimation
+            {
+                duration: 250
+            }
+        }
+    }
+
+    FeaturedImagesPage
+    {
+        id: featuredImagesPage
+        anchors.fill: parent
+        opacity: 0
+        visible: opacity > 0.01
+
+        Behavior on opacity {
+            NumberAnimation
+            {
+                duration: 250
+            }
+        }
+    }
+
     states: [
         State {
             name: "loading"
@@ -364,6 +424,27 @@ Item
         }
     ]
 
+    function showFeaturedVideosPage()
+    {
+        resultsLayout.opacity = 0
+        featuredVideosPage.opacity = 1
+        popup = true
+    }
+
+    function showFeaturedPacksPage()
+    {
+        resultsLayout.opacity = 0
+        featuredPacksPage.opacity = 1
+        popup = true
+    }
+
+    function showFeaturedImagesPage()
+    {
+        resultsLayout.opacity = 0
+        featuredImagesPage.opacity = 1
+        popup = true
+    }
+
     function showImagePopup(index)
     {
         viewMoreImagePopup.author = imagesModel.data(imagesModel.index(index,0), FeaturedImagesModel.AuthorRole)
@@ -415,6 +496,25 @@ Item
 
     function closePopup()
     {
+        if(featuredVideosPage.popup)
+        {
+            featuredVideosPage.closePopup()
+            return
+        }
+        if(featuredImagesPage.popup)
+        {
+            featuredImagesPage.closePopup()
+            return
+        }
+        if(featuredPacksPage.popup)
+        {
+            featuredPacksPage.closePopup()
+            return
+        }
+
+        featuredVideosPage.opacity = 0
+        featuredImagesPage.opacity = 0
+        featuredPacksPage.opacity = 0
         viewMoreImagePopup.opacity = 0
         viewMoreVideoPopup.opacity = 0
         viewMoreWallpaperPopup.opacity = 0

KomplexHubModule/Controls/HorizontalPaginator.qml

@@ -25,6 +25,8 @@ Item
 
     property Component delegate
 
+    signal viewMoreTriggered()
+
     id: rootItem
 
     Item
@@ -162,6 +164,8 @@ Item
                     icon.source: "qrc:/images/icons/icons8-forward.svg"
                     icon.height: 24
                     icon.width: 24
+
+                    onTriggered: () => viewMoreTriggered()
                 }
             }
         }

KomplexHubPlugin/CMakeLists.txt

@@ -19,23 +19,17 @@ qt_add_qml_module(
       newestpacksmodel.cpp
       common/komplex_global.h
       common/slidingcachecontroller.h
-        common/paginator.h
       common/coreservices.h
       common/coreservices.cpp
       common/logging.h
       common/fetchresult.h
+      paginators/paginator.h
       paginators/newestpackspaginator.h
       paginators/featuredpackspaginator.h
       paginators/featuredimagespaginator.h
       paginators/wallpaperpaginator.h
       paginators/packsearchpaginator.h
       paginators/imagesearchpaginator.h
-        paginators/newestshaderspaginator.h
-        paginators/newestcubemapspaginator.h
-        paginators/featuredshaderspaginator.h
-        paginators/featuredcubemapspaginator.h
-        paginators/searchshaderspaginator.h
-        paginators/searchcubemapspaginator.h
       paginators/videosearchpaginator.h
       featuredpacksmodel.h
       featuredpacksmodel.cpp
@@ -60,7 +54,8 @@ qt_add_qml_module(
       common/exceptions.h
       common/shadertoymetadata.h
       common/shaderpack.h
-        SOURCES packcompiler.h packcompiler.cpp
+      packcompiler.h
+      packcompiler.cpp
 )
 
 target_compile_definitions(
@@ -69,9 +64,12 @@ target_compile_definitions(
         KOMPLEX_PLUGIN
 )
 
+add_subdirectory(3rdparty/qtkeychain)
+
 target_link_libraries(KomplexHubPlugin PRIVATE
     Qt${QT_VERSION_MAJOR}::Core
     Qt${QT_VERSION_MAJOR}::Gui
+    qt6keychain
 )
 
 if(ENABLE_ASAN)

KomplexHubPlugin/common/komplex_global.h

@@ -19,6 +19,7 @@
 #ifndef KOMPLEX_GLOBAL_H
 #define KOMPLEX_GLOBAL_H
 #include <QtTypes>
+#include <QString>
 #include <chrono>
 
 #ifdef KOMPLEX_PLUGIN
@@ -66,5 +67,14 @@
 
 inline static qsizetype nullsize = std::numeric_limits<qsizetype>::min();
 inline static std::chrono::milliseconds KOMPLEX_RATE_LIMIT(500);
+inline static QString KOMPLEX_KEYCHAIN_PASSWORD_KEY = QStringLiteral
+(
+    "com.digitalartifex.komplex.keychain.password"
+);
+
+inline static QString KOMPLEX_KEYCHAIN_TOKEN_KEY = QStringLiteral
+(
+    "com.digitalartifex.komplex.keychain.token"
+);
 
 #endif // KOMPLEX_GLOBAL_H

KomplexHubPlugin/common/slidingcachecontroller.h

@@ -337,6 +337,13 @@ private:
             return false;
         }
 
+        qsizetype windowSize = this->windowSize();
+
+        if(windowSize == 0)
+        {
+            windowSize = SLIDING_CACHE_WINDOW_SIZE;
+        }
+
         while (index >= m_windowOffset + (SLIDING_CACHE_WINDOW_SIZE - SLIDING_CACHE_PREFETCH_THRESHOLD))
         {
             if(!slideForward())

KomplexHubPlugin/featuredimagesmodel.cpp

@@ -245,7 +245,6 @@ auto FeaturedImagesModel::resultsPerPage() const -> qsizetype
 
 auto FeaturedImagesModel::setResultsPerPage(qsizetype resultsPerPage) -> void
 {
-
     if(m_paginator != nullptr)
     {
         QFuture<void> future = QtConcurrent::run

KomplexHubPlugin/featuredimagesmodel.h

@@ -248,7 +248,6 @@ signals:
     auto stateChanged() -> void;
     auto errorStringChanged() -> void;
     auto resultsPerPageChanged() -> void;
-
     auto pageChanged() -> void;
     auto totalResultsChanged() -> void;
     auto totalPagesChanged() -> void;

KomplexHubPlugin/featuredvideosmodel.cpp

@@ -205,6 +205,24 @@ auto FeaturedVideosModel::itemModel() const -> VideoItemModel*
     return m_itemModel;
 }
 
+auto FeaturedVideosModel::windowSize() const -> qsizetype
+{
+    if(m_paginator == nullptr)
+    {
+        return 0;
+    }
+
+    return m_paginator->windowSize();
+}
+
+auto FeaturedVideosModel::setWindowSize(qsizetype size) -> void
+{
+    if(m_paginator != nullptr)
+    {
+        m_paginator->setWindowSize(size);
+    }
+}
+
 auto FeaturedVideosModel::roleNames() const -> QHash<int, QByteArray>
 {
     return m_dataRoles;

KomplexHubPlugin/featuredvideosmodel.h

@@ -217,6 +217,20 @@ public:
 
     VideoItemModel *itemModel() const;
 
+    /**
+     * @brief windowSize
+     * Paginator cache size
+     * @return
+     */
+    auto windowSize() const -> qsizetype;
+
+    /**
+     * @brief setWindowSize
+     * Set the paginator cache size
+     * @param size
+     */
+    auto setWindowSize(qsizetype size) -> void;
+
 protected:
     /**
      * @brief setErrorString
@@ -243,7 +257,7 @@ signals:
     auto stateChanged() -> void;
     auto errorStringChanged() -> void;
     auto resultsPerPageChanged() -> void;
-
+    auto windowSizeChanged() -> void;
     auto pageChanged() -> void;
     auto totalResultsChanged() -> void;
     auto totalPagesChanged() -> void;
@@ -314,6 +328,7 @@ private:
     Q_PROPERTY(qsizetype totalPages READ totalPages NOTIFY totalPagesChanged FINAL)
     Q_PROPERTY(qsizetype page READ page NOTIFY pageChanged FINAL)
     Q_PROPERTY(VideoItemModel *itemModel READ itemModel CONSTANT FINAL)
+    Q_PROPERTY(qsizetype windowSize READ windowSize WRITE setWindowSize NOTIFY windowSizeChanged FINAL)
 };
 Q_DECLARE_METATYPE(FeaturedVideosModel)
 

KomplexHubPlugin/paginators/featuredcubemapspaginator.h

@@ -1,47 +0,0 @@
-/*
- *  Komplex Wallpaper Engine
- *  Copyright (C) 2026 @DigitalArtifex
- *  https://digitalartifex.dev - https://github.com/DigitalArtifex
- *
- *  This program is free software: you can redistribute it and/or modify
- *  it under the terms of the GNU General Public License as published by
- *  the Free Software Foundation, either version 3 of the License, or
- *  (at your option) any later version.
- *
- *  This program is distributed in the hope that it will be useful,
- *  but WITHOUT ANY WARRANTY; without even the implied warranty of
- *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- *  GNU General Public License for more details.
- *
- *  You should have received a copy of the GNU General Public License
- *  along with this program.  If not, see <https://www.gnu.org/licenses/>
- */
-#ifndef FEATUREDCUBEMAPSPAGINATOR_H
-#define FEATUREDCUBEMAPSPAGINATOR_H
-
-#include <QObject>
-#include <QNetworkAccessManager>
-#include <QNetworkReply>
-#include <QNetworkRequest>
-#include <QEventLoop>
-#include <QJsonDocument>
-#include <QJsonParseError>
-#include <QJsonArray>
-#include <QJsonObject>
-
-#include "wallpaperpaginator.h"
-
-class KOMPLEX_EXPORT FeaturedCubemapsPaginator : public WallpaperPaginator
-{
-public:
-    explicit FeaturedCubemapsPaginator(QObject *parent = nullptr) : WallpaperPaginator(parent)
-    {
-        setUri(
-            QString::fromUtf8(KOMPLEX_ENDPOINT_CUBEMAPS_FEATURED)
-        );
-
-        controller()->setWindowSize(20);
-    }
-};
-
-#endif // FEATUREDCUBEMAPSPAGINATOR_H

KomplexHubPlugin/paginators/featuredshaderspaginator.h

@@ -1,47 +0,0 @@
-/*
- *  Komplex Wallpaper Engine
- *  Copyright (C) 2026 @DigitalArtifex
- *  https://digitalartifex.dev - https://github.com/DigitalArtifex
- *
- *  This program is free software: you can redistribute it and/or modify
- *  it under the terms of the GNU General Public License as published by
- *  the Free Software Foundation, either version 3 of the License, or
- *  (at your option) any later version.
- *
- *  This program is distributed in the hope that it will be useful,
- *  but WITHOUT ANY WARRANTY; without even the implied warranty of
- *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- *  GNU General Public License for more details.
- *
- *  You should have received a copy of the GNU General Public License
- *  along with this program.  If not, see <https://www.gnu.org/licenses/>
- */
-#ifndef FEATUREDSHADERSPAGINATOR_H
-#define FEATUREDSHADERSPAGINATOR_H
-
-#include <QObject>
-#include <QNetworkAccessManager>
-#include <QNetworkReply>
-#include <QNetworkRequest>
-#include <QEventLoop>
-#include <QJsonDocument>
-#include <QJsonParseError>
-#include <QJsonArray>
-#include <QJsonObject>
-
-#include "wallpaperpaginator.h"
-
-class KOMPLEX_EXPORT FeaturedShadersPaginator : public WallpaperPaginator
-{
-public:
-    explicit FeaturedShadersPaginator(QObject *parent = nullptr) : WallpaperPaginator(parent)
-    {
-        setUri(
-            QString::fromUtf8(KOMPLEX_ENDPOINT_SHADERS_FEATURED)
-        );
-
-        controller()->setWindowSize(20);
-    }
-};
-
-#endif // FEATUREDSHADERSPAGINATOR_H

KomplexHubPlugin/paginators/imagepaginator.h

@@ -30,9 +30,9 @@
 #include <QJsonObject>
 
 #include "common/logging.h"
-#include "common/paginator.h"
 #include "common/imagecache.h"
 #include "common/coreservices.h"
+#include "paginator.h"
 
 /**
  * @brief The ImagePaginator class

KomplexHubPlugin/paginators/newestcubemapspaginator.h

@@ -1,45 +0,0 @@
-/*
- *  Komplex Wallpaper Engine
- *  Copyright (C) 2026 @DigitalArtifex
- *  https://digitalartifex.dev - https://github.com/DigitalArtifex
- *
- *  This program is free software: you can redistribute it and/or modify
- *  it under the terms of the GNU General Public License as published by
- *  the Free Software Foundation, either version 3 of the License, or
- *  (at your option) any later version.
- *
- *  This program is distributed in the hope that it will be useful,
- *  but WITHOUT ANY WARRANTY; without even the implied warranty of
- *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- *  GNU General Public License for more details.
- *
- *  You should have received a copy of the GNU General Public License
- *  along with this program.  If not, see <https://www.gnu.org/licenses/>
- */
-#ifndef NEWESTCUBEMAPSPAGINATOR_H
-#define NEWESTCUBEMAPSPAGINATOR_H
-
-#include <QObject>
-#include <QNetworkAccessManager>
-#include <QNetworkReply>
-#include <QNetworkRequest>
-#include <QEventLoop>
-#include <QJsonDocument>
-#include <QJsonParseError>
-#include <QJsonArray>
-#include <QJsonObject>
-
-#include "wallpaperpaginator.h"
-
-class KOMPLEX_EXPORT NewestCubemapsPaginator : public WallpaperPaginator
-{
-public:
-    explicit NewestCubemapsPaginator(QObject *parent = nullptr) : WallpaperPaginator(parent)
-    {
-        setUri(
-            QString::fromUtf8(KOMPLEX_ENDPOINT_CUBEMAPS_NEWEST)
-        );
-    }
-};
-
-#endif // NEWESTCUBEMAPSPAGINATOR_H

KomplexHubPlugin/paginators/newestshaderspaginator.h

@@ -1,45 +0,0 @@
-/*
- *  Komplex Wallpaper Engine
- *  Copyright (C) 2026 @DigitalArtifex
- *  https://digitalartifex.dev - https://github.com/DigitalArtifex
- *
- *  This program is free software: you can redistribute it and/or modify
- *  it under the terms of the GNU General Public License as published by
- *  the Free Software Foundation, either version 3 of the License, or
- *  (at your option) any later version.
- *
- *  This program is distributed in the hope that it will be useful,
- *  but WITHOUT ANY WARRANTY; without even the implied warranty of
- *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- *  GNU General Public License for more details.
- *
- *  You should have received a copy of the GNU General Public License
- *  along with this program.  If not, see <https://www.gnu.org/licenses/>
- */
-#ifndef NEWESTSHADERSPAGINATOR_H
-#define NEWESTSHADERSPAGINATOR_H
-
-#include <QObject>
-#include <QNetworkAccessManager>
-#include <QNetworkReply>
-#include <QNetworkRequest>
-#include <QEventLoop>
-#include <QJsonDocument>
-#include <QJsonParseError>
-#include <QJsonArray>
-#include <QJsonObject>
-
-#include "wallpaperpaginator.h"
-
-class KOMPLEX_EXPORT NewestShadersPaginator : public WallpaperPaginator
-{
-public:
-    explicit NewestShadersPaginator(QObject *parent = nullptr) : WallpaperPaginator(parent)
-    {
-        setUri(
-            QString::fromUtf8(KOMPLEX_ENDPOINT_SHADERS_NEWEST)
-        );
-    }
-};
-
-#endif // NEWESTSHADERSPAGINATOR_H

KomplexHubPlugin/paginators/paginator.h

@@ -27,8 +27,8 @@
 #include <QJsonDocument>
 #include <QJsonParseError>
 
-#include "komplex_global.h"
-#include "slidingcachecontroller.h"
+#include "common/komplex_global.h"
+#include "common/slidingcachecontroller.h"
 
 /**
  * @brief The PaginationNotifier class
@@ -120,6 +120,7 @@ public:
      * @brief resultsPerPage
      * @return
      */
+    [[nodiscard]]
     auto resultsPerPage() const -> qsizetype
     {
         return m_resultsPerPage;
@@ -204,6 +205,7 @@ public:
      * @brief data
      * @return
      */
+    [[nodiscard]]
     auto data() const -> const QList<T>
     {
         if(boundaryCheck(m_resultsPerPage))
@@ -219,6 +221,7 @@ public:
      * @brief count
      * @return
      */
+    [[nodiscard]]
     auto count() const -> qsizetype
     {
         if(m_offset == nullsize)
@@ -240,6 +243,7 @@ public:
      * @param index
      * @return
      */
+    [[nodiscard]]
     auto at(qsizetype index) const -> const T&
     {
         return m_cacheController.at(m_offset + index);
@@ -251,6 +255,7 @@ public:
      * The total number of results as reported by the controller
      * @return
      */
+    [[nodiscard]]
     auto totalResults() const -> qsizetype
     {
         return m_cacheController.totalCount();
@@ -261,6 +266,7 @@ public:
      * Calculates the current page
      * @return
      */
+    [[nodiscard]]
     auto page() const -> qsizetype
     {
         return std::floor(
@@ -273,6 +279,7 @@ public:
      * Calculates the total number of pages available
      * @return
      */
+    [[nodiscard]]
     auto totalPages() const -> qsizetype
     {
         return std::ceil(
@@ -280,6 +287,22 @@ public:
         );
     }
 
+    /**
+     * @brief setWindowSize
+     * Sets the controller window size
+     * @return
+     */
+    auto setWindowSize(qsizetype size) -> void
+    {
+        m_cacheController.setWindowSize(size);
+    }
+
+    [[nodiscard]]
+    auto windowSize() const -> qsizetype
+    {
+        return m_cacheController.windowSize();
+    }
+
 protected:
 
     auto queryable() const -> bool

KomplexHubPlugin/paginators/searchcubemapspaginator.h

@@ -1,45 +0,0 @@
-/*
- *  Komplex Wallpaper Engine
- *  Copyright (C) 2026 @DigitalArtifex
- *  https://digitalartifex.dev - https://github.com/DigitalArtifex
- *
- *  This program is free software: you can redistribute it and/or modify
- *  it under the terms of the GNU General Public License as published by
- *  the Free Software Foundation, either version 3 of the License, or
- *  (at your option) any later version.
- *
- *  This program is distributed in the hope that it will be useful,
- *  but WITHOUT ANY WARRANTY; without even the implied warranty of
- *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- *  GNU General Public License for more details.
- *
- *  You should have received a copy of the GNU General Public License
- *  along with this program.  If not, see <https://www.gnu.org/licenses/>
- */
-#ifndef SEARCHCUBEMAPSPAGINATOR_H
-#define SEARCHCUBEMAPSPAGINATOR_H
-
-#include <QObject>
-#include <QNetworkAccessManager>
-#include <QNetworkReply>
-#include <QNetworkRequest>
-#include <QEventLoop>
-#include <QJsonDocument>
-#include <QJsonParseError>
-#include <QJsonArray>
-#include <QJsonObject>
-
-#include "wallpaperpaginator.h"
-
-class KOMPLEX_EXPORT SearchCubemapsPaginator : public WallpaperPaginator
-{
-public:
-    explicit SearchCubemapsPaginator(QObject *parent = nullptr) : WallpaperPaginator(parent)
-    {
-        setUri(
-            QString::fromUtf8(KOMPLEX_ENDPOINT_CUBEMAPS_SEARCH)
-        );
-    }
-};
-
-#endif // SEARCHCUBEMAPSPAGINATOR_H

KomplexHubPlugin/paginators/searchshaderspaginator.h

@@ -1,45 +0,0 @@
-/*
- *  Komplex Wallpaper Engine
- *  Copyright (C) 2026 @DigitalArtifex
- *  https://digitalartifex.dev - https://github.com/DigitalArtifex
- *
- *  This program is free software: you can redistribute it and/or modify
- *  it under the terms of the GNU General Public License as published by
- *  the Free Software Foundation, either version 3 of the License, or
- *  (at your option) any later version.
- *
- *  This program is distributed in the hope that it will be useful,
- *  but WITHOUT ANY WARRANTY; without even the implied warranty of
- *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
- *  GNU General Public License for more details.
- *
- *  You should have received a copy of the GNU General Public License
- *  along with this program.  If not, see <https://www.gnu.org/licenses/>
- */
-#ifndef SEARCHSHADERSPAGINATOR_H
-#define SEARCHSHADERSPAGINATOR_H
-
-#include <QObject>
-#include <QNetworkAccessManager>
-#include <QNetworkReply>
-#include <QNetworkRequest>
-#include <QEventLoop>
-#include <QJsonDocument>
-#include <QJsonParseError>
-#include <QJsonArray>
-#include <QJsonObject>
-
-#include "wallpaperpaginator.h"
-
-class KOMPLEX_EXPORT SearchShadersPaginator : public WallpaperPaginator
-{
-public:
-    explicit SearchShadersPaginator(QObject *parent = nullptr) : WallpaperPaginator(parent)
-    {
-        setUri(
-            QString::fromUtf8(KOMPLEX_ENDPOINT_SHADERS_SEARCH)
-        );
-    }
-};
-
-#endif // SEARCHSHADERSPAGINATOR_H

KomplexHubPlugin/paginators/videopaginator.h

@@ -30,9 +30,9 @@
 #include <QJsonObject>
 
 #include "common/logging.h"
-#include "common/paginator.h"
 #include "common/videocache.h"
 #include "common/coreservices.h"
+#include "paginator.h"
 
 /**
  * @brief The VideoPaginator class

KomplexHubPlugin/paginators/wallpaperpaginator.h

@@ -30,9 +30,9 @@
 #include <QJsonObject>
 
 #include "common/logging.h"
-#include "common/paginator.h"
 #include "common/wallpapercache.h"
 #include "common/coreservices.h"
+#include "paginator.h"
 
 /**
  * @brief The WallpaperPaginator class

POLICY_AI.md

@@ -0,0 +1,91 @@
+# Komplex AI Usage Policy (Draft)
+
+| Applies To | Effective Date | Revision Date |
+| ------ | --- | --- |
+| Internal & Contributors | August 12, 2026 | August 12, 2026 |
+
+This policy may be updated in the future. The updated date will be reflected on this file.
+
+## Applies to
+This policy applies to contributors to Komplex and all associated repositories under the Komplex project umbrella.
+It outlines how artificial intelligence (AI) tools and systems may be used responsibly in the context of this project.
+
+Our goal is to encourage innovation and productivity while protecting our users, contributors, community, and the integrity of our open source projects. We want to enable employees and contractors to understand what is, and is not, acceptable, and enable the wider community to understand and have trust in how we operate. 
+
+## Scope
+This policy applies to any use of AI tools that can materially influence repository outputs, including:
+- Generative AI (e.g., image, text and code assistants)
+- AI-assisted development tools (e.g., code completion and refactoring assistants)
+- Tools that can generate diffs, patches, or substantial edits
+- Tools that can draft or summarize issues, bug reports, or diagnostics
+- Tools that can generate translations files and reports
+- Agenic automation of project tasks
+
+## Guiding principles
+1. Human responsibility: Humans remain accountable for decisions, code, and outputs.
+2. Transparency: If AI materially contributes to the output, disclose it clearly and concisely in pull requests, commit messages, or accompanying documentation where appropriate.
+3. Safety and quality: AI-generated suggestions must be reviewed and validated by humans before being adopted.
+4. Integrity and authorship: AI must not be used to bypass authorship, review, or verification requirements.
+5. Community and ecosystem trust: AI must not be used to mislead reviewers or circumvent project quality standards.
+
+## Prohibited uses of AI
+AI tools may not be used for:
+- Agentic generation of code, patches, diffs, or substantial edits intended to become part of the repository.
+- Produce a complete file replacement, complete module, or end-to-end implementation of a feature.
+- Generate bug report details or where the bug report content would be primarily AI-authored.
+
+### “Agentic” Automation
+You may not use AI tools that can take actions on your behalf without intentional invocation. For example browsing, running commands, editing files and repositories, or opening pull requests automatically.
+
+### Misrepresentation and undisclosed material contribution
+Misrepresentation of AI-assisted work as human-authored where disclosure is required by this policy is subject to enforcement policies.
+
+## Acceptable uses of AI
+AI tools may be used to:
+- Assist with writing or refactoring code, provided the resulting code changes are implemented, reviewed and verified by a human contributor.
+- Generating support documentation that is based on human-authored doxygen comments.
+- Help with debugging by reviewing code, generating hypotheses and proposing targeted experiments to identify root cause in existing code.
+- Translate a human-authored bug report into another language, or reformat a human-authored report for clarity.
+- Translate and generate application translation files (including strings and localized resources), subject to human review.
+- Generate images and icons when used only as placeholders, with the intention to replace them with project-approved assets.
+
+All acceptable uses are subject to change.
+
+### Bug Reports
+You must write the factual and investigative aspects of bug reports yourself.
+For reporting AI may be used only to:
+- Reformat or rewrite for clarity while preserving the original factual content
+- Help translate the human-authored report into a different structure, language, or style
+
+### Implementation
+- You must implement changes yourself.
+- You must verify changes via tests, linting/type checks, and/or manual validation consistent with project standards.
+- Do not copy/paste AI-generated patches as the final solution.
+
+### Media placeholders
+AI-generated images/icons may be used only as placeholders with the intention to replace them.
+
+- Placeholder files must be clearly marked in the AI_ASSETS file.
+- Placeholders should be replaced when possible, but may require artist contribution and may not always be immediately feasible.
+
+### Qt Translation Files
+- AI may be used to generate translation files.
+- AI generated translation files must be noted in AI_ASSETS
+
+## Transparency and disclosure
+When disclosing the use of AI generated assets, you must disclose:
+- The file name and path relative to the project root
+- Which allowed category was used (e.g., translation file generation, bug report translation, placeholder media)
+- What tool/version was used for generation
+- Optionally can include a short message about the asset
+
+## Enforcement
+Failure to comply with this policy may result in:
+
+- Requesting changes to bring contributions back into compliance
+- Rejection of pull requests
+- Removal of contributor privileges where applicable
+- Escalation to maintainers for further action
+
+## Policy values statement
+AI is a tool, not a substitute for responsibility. In Komplex, AI may be used to increase productivity and assist with debugging, review, translation, and placeholders, but humans must remain accountable for the correctness, safety, and authorship of repository outputs.