novelWriter 2.3.1__py3-none-any.whl → 2.4rc1__py3-none-any.whl

novelwriter/tools/manuscript.py

@@ -26,29 +26,36 @@ from __future__ import annotations
 import json
 import logging
 
+from datetime import datetime
 from time import time
 from typing import TYPE_CHECKING
-from datetime import datetime
 
+from PyQt5.QtCore import QTimer, QUrl, Qt, pyqtSignal, pyqtSlot
 from PyQt5.QtGui import QCloseEvent, QColor, QCursor, QFont, QPalette, QResizeEvent
-from PyQt5.QtCore import QSize, QTimer, Qt, pyqtSlot
+from PyQt5.QtPrintSupport import QPrintPreviewDialog, QPrinter
 from PyQt5.QtWidgets import (
-    QAbstractItemView, QDialog, QGridLayout, QHBoxLayout, QLabel, QListWidget,
-    QListWidgetItem, QPushButton, QSplitter, QTextBrowser, QToolButton,
-    QTreeWidget, QTreeWidgetItem, QVBoxLayout, QWidget, qApp
+    QAbstractItemView, QApplication, QDialog, QFormLayout, QGridLayout,
+    QHBoxLayout, QLabel, QListWidget, QListWidgetItem, QPushButton,
+    QSizePolicy, QSplitter, QStackedWidget, QTabWidget, QTextBrowser,
+    QTreeWidget, QTreeWidgetItem, QVBoxLayout, QWidget
 )
-from PyQt5.QtPrintSupport import QPrintPreviewDialog, QPrinter
 
 from novelwriter import CONFIG, SHARED
-from novelwriter.error import logException
 from novelwriter.common import checkInt, fuzzyTime
-from novelwriter.core.tohtml import ToHtml
+from novelwriter.core.buildsettings import BuildCollection, BuildSettings
 from novelwriter.core.docbuild import NWBuildDocument
+from novelwriter.core.tohtml import ToHtml
 from novelwriter.core.tokenizer import HeadingFormatter
-from novelwriter.core.buildsettings import BuildCollection, BuildSettings
+from novelwriter.error import logException
+from novelwriter.extensions.circularprogress import NProgressCircle
+from novelwriter.extensions.modified import NIconToggleButton, NIconToolButton
+from novelwriter.gui.theme import STYLES_FLAT_TABS, STYLES_MIN_TOOLBUTTON
 from novelwriter.tools.manusbuild import GuiManuscriptBuild
 from novelwriter.tools.manussettings import GuiBuildSettings
-from novelwriter.extensions.circularprogress import NProgressCircle
+from novelwriter.types import (
+    QtAlignAbsolute, QtAlignCenter, QtAlignJustify, QtAlignRight, QtAlignTop,
+    QtUserRole
+)
 
 if TYPE_CHECKING:  # pragma: no cover
     from novelwriter.guimain import GuiMain
@@ -64,7 +71,7 @@ class GuiManuscript(QDialog):
     a document directly to disk.
     """
 
-    D_KEY = Qt.ItemDataRole.UserRole
+    D_KEY = QtUserRole
 
     def __init__(self, mainGui: GuiMain) -> None:
         super().__init__(parent=mainGui)
@@ -83,7 +90,7 @@ class GuiManuscript(QDialog):
         self.setMinimumWidth(CONFIG.pxInt(600))
         self.setMinimumHeight(CONFIG.pxInt(500))
 
-        iPx = SHARED.theme.baseIconSize
+        iSz = SHARED.theme.baseIconSize
         wWin = CONFIG.pxInt(900)
         hWin = CONFIG.pxInt(600)
 
@@ -97,37 +104,27 @@ class GuiManuscript(QDialog):
         # ==============
 
         qPalette = self.palette()
-        qPalette.setBrush(QPalette.Window, qPalette.base())
+        qPalette.setBrush(QPalette.ColorRole.Window, qPalette.base())
         self.setPalette(qPalette)
 
-        fadeCol = qPalette.text().color()
-        buttonStyle = (
-            "QToolButton {{padding: {0}px; border: none; background: transparent;}} "
-            "QToolButton:hover {{border: none; background: rgba({1},{2},{3},0.2);}}"
-        ).format(CONFIG.pxInt(2), fadeCol.red(), fadeCol.green(), fadeCol.blue())
+        buttonStyle = SHARED.theme.getStyleSheet(STYLES_MIN_TOOLBUTTON)
 
-        self.tbAdd = QToolButton(self)
-        self.tbAdd.setIcon(SHARED.theme.getIcon("add"))
-        self.tbAdd.setIconSize(QSize(iPx, iPx))
+        self.tbAdd = NIconToolButton(self, iSz, "add")
         self.tbAdd.setToolTip(self.tr("Add New Build"))
         self.tbAdd.setStyleSheet(buttonStyle)
         self.tbAdd.clicked.connect(self._createNewBuild)
 
-        self.tbDel = QToolButton(self)
-        self.tbDel.setIcon(SHARED.theme.getIcon("remove"))
-        self.tbDel.setIconSize(QSize(iPx, iPx))
+        self.tbDel = NIconToolButton(self, iSz, "remove")
         self.tbDel.setToolTip(self.tr("Delete Selected Build"))
         self.tbDel.setStyleSheet(buttonStyle)
         self.tbDel.clicked.connect(self._deleteSelectedBuild)
 
-        self.tbEdit = QToolButton(self)
-        self.tbEdit.setIcon(SHARED.theme.getIcon("edit"))
-        self.tbEdit.setIconSize(QSize(iPx, iPx))
+        self.tbEdit = NIconToolButton(self, iSz, "edit")
         self.tbEdit.setToolTip(self.tr("Edit Selected Build"))
         self.tbEdit.setStyleSheet(buttonStyle)
         self.tbEdit.clicked.connect(self._editSelectedBuild)
 
-        self.lblBuilds = QLabel("<b>{0}</b>".format(self.tr("Builds")))
+        self.lblBuilds = QLabel("<b>{0}</b>".format(self.tr("Builds")), self)
 
         self.listToolBox = QHBoxLayout()
         self.listToolBox.addWidget(self.lblBuilds)
@@ -140,21 +137,31 @@ class GuiManuscript(QDialog):
         # Builds
         # ======
 
-        self.buildList = QListWidget()
-        self.buildList.setIconSize(QSize(iPx, iPx))
+        self.buildList = QListWidget(self)
+        self.buildList.setIconSize(iSz)
         self.buildList.doubleClicked.connect(self._editSelectedBuild)
         self.buildList.currentItemChanged.connect(self._updateBuildDetails)
-        self.buildList.setSelectionMode(QAbstractItemView.SingleSelection)
-        self.buildList.setDragDropMode(QAbstractItemView.InternalMove)
+        self.buildList.setSelectionMode(QAbstractItemView.SelectionMode.SingleSelection)
+        self.buildList.setDragDropMode(QAbstractItemView.DragDropMode.InternalMove)
+
+        # Details Tabs
+        # ============
 
         self.buildDetails = _DetailsWidget(self)
         self.buildDetails.setColumnWidth(
             CONFIG.pxInt(pOptions.getInt("GuiManuscript", "detailsWidth", 100)),
         )
 
+        self.buildOutline = _OutlineWidget(self)
+
+        self.detailsTabs = QTabWidget(self)
+        self.detailsTabs.addTab(self.buildDetails, self.tr("Build"))
+        self.detailsTabs.addTab(self.buildOutline, self.tr("Outline"))
+        self.detailsTabs.setStyleSheet(SHARED.theme.getStyleSheet(STYLES_FLAT_TABS))
+
         self.buildSplit = QSplitter(Qt.Orientation.Vertical, self)
         self.buildSplit.addWidget(self.buildList)
-        self.buildSplit.addWidget(self.buildDetails)
+        self.buildSplit.addWidget(self.detailsTabs)
         self.buildSplit.setSizes([
             CONFIG.pxInt(pOptions.getInt("GuiManuscript", "listHeight", 50)),
             CONFIG.pxInt(pOptions.getInt("GuiManuscript", "detailsHeight", 50)),
@@ -163,16 +170,16 @@ class GuiManuscript(QDialog):
         # Process Controls
         # ================
 
-        self.btnPreview = QPushButton(self.tr("Preview"))
+        self.btnPreview = QPushButton(self.tr("Preview"), self)
         self.btnPreview.clicked.connect(self._generatePreview)
 
-        self.btnPrint = QPushButton(self.tr("Print"))
+        self.btnPrint = QPushButton(self.tr("Print"), self)
         self.btnPrint.clicked.connect(self._printDocument)
 
-        self.btnBuild = QPushButton(self.tr("Build"))
+        self.btnBuild = QPushButton(self.tr("Build"), self)
         self.btnBuild.clicked.connect(self._buildManuscript)
 
-        self.btnClose = QPushButton(self.tr("Close"))
+        self.btnClose = QPushButton(self.tr("Close"), self)
         self.btnClose.clicked.connect(self.close)
 
         self.processBox = QGridLayout()
@@ -185,6 +192,15 @@ class GuiManuscript(QDialog):
         # ============
 
         self.docPreview = _PreviewWidget(self)
+        self.docStats = _StatsWidget(self)
+
+        self.docBox = QVBoxLayout()
+        self.docBox.addWidget(self.docPreview, 1)
+        self.docBox.addWidget(self.docStats, 0)
+        self.docBox.setContentsMargins(0, 0, 0, 0)
+
+        self.docWdiget = QWidget(self)
+        self.docWdiget.setLayout(self.docBox)
 
         self.controlBox = QVBoxLayout()
         self.controlBox.addLayout(self.listToolBox, 0)
@@ -192,12 +208,12 @@ class GuiManuscript(QDialog):
         self.controlBox.addLayout(self.processBox, 0)
         self.controlBox.setContentsMargins(0, 0, 0, 0)
 
-        self.optsWidget = QWidget()
+        self.optsWidget = QWidget(self)
         self.optsWidget.setLayout(self.controlBox)
 
-        self.mainSplit = QSplitter()
+        self.mainSplit = QSplitter(self)
         self.mainSplit.addWidget(self.optsWidget)
-        self.mainSplit.addWidget(self.docPreview)
+        self.mainSplit.addWidget(self.docWdiget)
         self.mainSplit.setCollapsible(0, False)
         self.mainSplit.setCollapsible(1, False)
         self.mainSplit.setStretchFactor(0, 0)
@@ -213,6 +229,9 @@ class GuiManuscript(QDialog):
         self.setLayout(self.outerBox)
         self.setSizeGripEnabled(True)
 
+        # Signals
+        self.buildOutline.outlineEntryClicked.connect(self.docPreview.navigateTo)
+
         logger.debug("Ready: GuiManuscript")
 
         return
@@ -245,7 +264,7 @@ class GuiManuscript(QDialog):
                 if isinstance(build, BuildSettings):
                     self._updatePreview(data, build)
             except Exception:
-                logger.error("Failed to save build cache")
+                logger.error("Failed to load build cache")
                 logException()
                 return
 
@@ -328,18 +347,21 @@ class GuiManuscript(QDialog):
             return
 
         docBuild = NWBuildDocument(SHARED.project, build)
+        docBuild.setPreviewMode(True)
         docBuild.queueAll()
 
         self.docPreview.beginNewBuild(len(docBuild))
         for step, _ in docBuild.iterBuildHTML(None):
             self.docPreview.buildStep(step + 1)
-            qApp.processEvents()
+            QApplication.processEvents()
 
         buildObj = docBuild.lastBuild
         assert isinstance(buildObj, ToHtml)
         result = {
             "uuid": build.buildID,
             "time": int(time()),
+            "stats": buildObj.textStats,
+            "outline": buildObj.textOutline,
             "styles": buildObj.getStyleSheet(),
             "html": buildObj.fullHTML,
         }
@@ -364,7 +386,7 @@ class GuiManuscript(QDialog):
         build = self._getSelectedBuild()
         if isinstance(build, BuildSettings):
             dlgBuild = GuiManuscriptBuild(self, build)
-            dlgBuild.exec_()
+            dlgBuild.exec()
 
             # After the build is done, save build settings changes
             if build.changed:
@@ -377,7 +399,7 @@ class GuiManuscript(QDialog):
         """Open the print preview dialog."""
         preview = QPrintPreviewDialog(self)
         preview.paintRequested.connect(self.docPreview.printPreview)
-        preview.exec_()
+        preview.exec()
         return
 
     ##
@@ -395,6 +417,8 @@ class GuiManuscript(QDialog):
         self.docPreview.setJustify(
             build.getBool("format.justifyText")
         )
+        self.docStats.updateStats(data.get("stats", {}))
+        self.buildOutline.updateOutline(data.get("outline", {}))
         return
 
     def _getSelectedBuild(self) -> BuildSettings | None:
@@ -463,7 +487,7 @@ class GuiManuscript(QDialog):
         dlgSettings.setModal(False)
         dlgSettings.show()
         dlgSettings.raise_()
-        qApp.processEvents()
+        QApplication.processEvents()
         dlgSettings.loadContent()
         dlgSettings.newSettingsReady.connect(self._processNewSettings)
 
@@ -503,8 +527,8 @@ class _DetailsWidget(QWidget):
         # Tree Widget
         self.listView = QTreeWidget(self)
         self.listView.setHeaderLabels([self.tr("Setting"), self.tr("Value")])
-        self.listView.setIndentation(SHARED.theme.baseIconSize)
-        self.listView.setSelectionMode(QAbstractItemView.NoSelection)
+        self.listView.setIndentation(SHARED.theme.baseIconHeight)
+        self.listView.setSelectionMode(QAbstractItemView.SelectionMode.NoSelection)
 
         # Assemble
         self.outerBox = QVBoxLayout()
@@ -592,24 +616,26 @@ class _DetailsWidget(QWidget):
         hFmt.resetScene()
         hFmt.incScene()
         title = self.tr("Title")
+        hidden = self.tr("Hidden")
 
         item = QTreeWidgetItem()
         item.setText(0, build.getLabel("headings"))
         item.setText(1, "")
         self.listView.addTopLevelItem(item)
-        entries = [
-            "headings.fmtTitle", "headings.fmtChapter", "headings.fmtUnnumbered",
-            "headings.fmtScene", "headings.fmtSection"
-        ]
-        for key in entries:
+        for hFormat, hHide in [
+            ("headings.fmtTitle", "headings.hideTitle"),
+            ("headings.fmtChapter", "headings.hideChapter"),
+            ("headings.fmtUnnumbered", "headings.hideUnnumbered"),
+            ("headings.fmtScene", "headings.hideScene"),
+            ("headings.fmtHardScene", "headings.hideHardScene"),
+            ("headings.fmtSection", "headings.hideSection"),
+        ]:
             sub = QTreeWidgetItem()
-            sub.setText(0, build.getLabel(key))
-            sub.setText(1, hFmt.apply(build.getStr(key), title, 0))
-            item.addChild(sub)
-        for key in ["headings.hideScene", "headings.hideSection"]:
-            sub = QTreeWidgetItem()
-            sub.setText(0, build.getLabel(key))
-            sub.setIcon(1, on if build.getBool(key) else off)
+            sub.setText(0, build.getLabel(hFormat))
+            if build.getBool(hHide):
+                sub.setText(1, f"[{hidden}]")
+            else:
+                sub.setText(1, hFmt.apply(build.getStr(hFormat), title, 0))
             item.addChild(sub)
 
         # Text Content
@@ -617,11 +643,10 @@ class _DetailsWidget(QWidget):
         item.setText(0, build.getLabel("text.grpContent"))
         item.setText(1, "")
         self.listView.addTopLevelItem(item)
-        entries = [
+        for key in [
             "text.includeSynopsis", "text.includeComments",
             "text.includeKeywords", "text.includeBodyText",
-        ]
-        for key in entries:
+        ]:
             sub = QTreeWidgetItem()
             sub.setText(0, build.getLabel(key))
             sub.setIcon(1, on if build.getBool(key) else off)
@@ -635,6 +660,87 @@ class _DetailsWidget(QWidget):
 # END Class _DetailsWidget
 
 
+class _OutlineWidget(QWidget):
+
+    D_LINE = QtUserRole
+
+    outlineEntryClicked = pyqtSignal(str)
+
+    def __init__(self, parent: QWidget) -> None:
+        super().__init__(parent=parent)
+
+        self._outline = {}
+
+        # Tree Widget
+        self.listView = QTreeWidget(self)
+        self.listView.setHeaderHidden(True)
+        self.listView.setSelectionMode(QAbstractItemView.SelectionMode.NoSelection)
+        self.listView.itemClicked.connect(self._onItemClick)
+
+        # Assemble
+        self.outerBox = QVBoxLayout()
+        self.outerBox.addWidget(self.listView)
+        self.outerBox.setContentsMargins(0, 0, 0, 0)
+        self.setLayout(self.outerBox)
+
+        return
+
+    def updateOutline(self, data: dict[str, str]) -> None:
+        """Update the outline."""
+        if isinstance(data, dict) and data != self._outline:
+            self.listView.clear()
+
+            tFont = self.font()
+            tFont.setBold(True)
+            tBrush = self.palette().highlight()
+
+            hFont = self.font()
+            hFont.setBold(True)
+            hFont.setUnderline(True)
+
+            root = self.listView.invisibleRootItem()
+            parent = root
+            indent = False
+            for anchor, entry in data.items():
+                prefix, _, text = entry.partition("|")
+                if prefix in ("TT", "PT", "CH", "SC", "H1", "H2"):
+                    item = QTreeWidgetItem([text])
+                    item.setData(0, self.D_LINE, anchor)
+                    if prefix == "TT":
+                        item.setFont(0, tFont)
+                        item.setForeground(0, tBrush)
+                        root.addChild(item)
+                        parent = root
+                    elif prefix == "PT":
+                        item.setFont(0, hFont)
+                        root.addChild(item)
+                        parent = root
+                    elif prefix in ("CH", "H1"):
+                        root.addChild(item)
+                        parent = item
+                    elif prefix in ("SC", "H2"):
+                        parent.addChild(item)
+                        indent = True
+
+            self.listView.setIndentation(
+                SHARED.theme.baseIconHeight if indent else CONFIG.pxInt(4)
+            )
+            self._outline = data
+
+        return
+
+    ##
+    #  Private Slots
+    ##
+
+    def _onItemClick(self, item: QTreeWidgetItem) -> None:
+        """Process tree item click."""
+        self.outlineEntryClicked.emit(str(item.data(0, self.D_LINE)))
+        return
+
+# END Class _OutlineWidget
+
+
 class _PreviewWidget(QTextBrowser):
 
     def __init__(self, parent: QWidget) -> None:
@@ -645,8 +751,8 @@ class _PreviewWidget(QTextBrowser):
 
         # Document Setup
         dPalette = self.palette()
-        dPalette.setColor(QPalette.Base, QColor(255, 255, 255))
-        dPalette.setColor(QPalette.Text, QColor(0, 0, 0))
+        dPalette.setColor(QPalette.ColorRole.Base, QColor(255, 255, 255))
+        dPalette.setColor(QPalette.ColorRole.Text, QColor(0, 0, 0))
         self.setPalette(dPalette)
 
         self.setMinimumWidth(40*SHARED.theme.textNWidth)
@@ -663,8 +769,8 @@ class _PreviewWidget(QTextBrowser):
 
         # Document Age
         aPalette = self.palette()
-        aPalette.setColor(QPalette.Background, aPalette.toolTipBase().color())
-        aPalette.setColor(QPalette.Foreground, aPalette.toolTipText().color())
+        aPalette.setColor(QPalette.ColorRole.Window, aPalette.toolTipBase().color())
+        aPalette.setColor(QPalette.ColorRole.WindowText, aPalette.toolTipText().color())
 
         aFont = self.font()
         aFont.setPointSizeF(0.9*SHARED.theme.fontPointSize)
@@ -674,7 +780,7 @@ class _PreviewWidget(QTextBrowser):
         self.ageLabel.setFont(aFont)
         self.ageLabel.setPalette(aPalette)
         self.ageLabel.setAutoFillBackground(True)
-        self.ageLabel.setAlignment(Qt.AlignCenter)
+        self.ageLabel.setAlignment(QtAlignCenter)
         self.ageLabel.setFixedHeight(int(2.1*SHARED.theme.fontPixelSize))
 
         # Progress
@@ -692,8 +798,8 @@ class _PreviewWidget(QTextBrowser):
         self._updateBuildAge()
 
         # Age Timer
-        self.ageTimer = QTimer()
-        self.ageTimer.setInterval(10)
+        self.ageTimer = QTimer(self)
+        self.ageTimer.setInterval(10000)
         self.ageTimer.timeout.connect(self._updateBuildAge)
         self.ageTimer.start()
 
@@ -713,9 +819,9 @@ class _PreviewWidget(QTextBrowser):
         """Enable/disable the justify text option."""
         pOptions = self.document().defaultTextOption()
         if state:
-            pOptions.setAlignment(Qt.AlignJustify)
+            pOptions.setAlignment(QtAlignJustify)
         else:
-            pOptions.setAlignment(Qt.AlignAbsolute)
+            pOptions.setAlignment(QtAlignAbsolute)
         self.document().setDefaultTextOption(pOptions)
         return
 
@@ -745,31 +851,24 @@ class _PreviewWidget(QTextBrowser):
     def buildStep(self, value: int) -> None:
         """Update the progress bar value."""
         self.buildProgress.setValue(value)
-        qApp.processEvents()
+        QApplication.processEvents()
         return
 
     def setContent(self, data: dict) -> None:
         """Set the content of the preview widget."""
         sPos = self.verticalScrollBar().value()
-        qApp.setOverrideCursor(QCursor(Qt.WaitCursor))
+        QApplication.setOverrideCursor(QCursor(Qt.CursorShape.WaitCursor))
 
         self.buildProgress.setCentreText(self.tr("Processing ..."))
-        qApp.processEvents()
-
-        styles = "\n".join(data.get("styles", [
-            "h1, h2 {color: rgb(66, 113, 174);}",
-            "h3, h4 {color: rgb(50, 50, 50);}",
-            "a {color: rgb(66, 113, 174);}",
-            ".tags {color: rgb(245, 135, 31); font-weight: bold;}",
-        ]))
+        QApplication.processEvents()
+
+        styles = "\n".join(data.get("styles", []))
         self.document().setDefaultStyleSheet(styles)
 
         html = "".join(data.get("html", []))
         html = html.replace("\t", "!!tab!!")
-        html = html.replace("<del>", "<span style='text-decoration: line-through;'>")
-        html = html.replace("</del>", "</span>")
         self.setHtml(html)
-        qApp.processEvents()
+        QApplication.processEvents()
         while self.find("!!tab!!"):
             cursor = self.textCursor()
             cursor.insertText("\t")
@@ -783,8 +882,8 @@ class _PreviewWidget(QTextBrowser):
         self.document().markContentsDirty(0, self.document().characterCount())
 
         self.buildProgress.setCentreText(self.tr("Done"))
-        qApp.restoreOverrideCursor()
-        qApp.processEvents()
+        QApplication.restoreOverrideCursor()
+        QApplication.processEvents()
         QTimer.singleShot(300, self._hideProgress)
 
         return
@@ -806,10 +905,17 @@ class _PreviewWidget(QTextBrowser):
     @pyqtSlot("QPrinter*")
     def printPreview(self, printer: QPrinter) -> None:
         """Connect the print preview painter to the document viewer."""
-        qApp.setOverrideCursor(QCursor(Qt.WaitCursor))
-        printer.setOrientation(QPrinter.Portrait)
+        QApplication.setOverrideCursor(QCursor(Qt.CursorShape.WaitCursor))
+        printer.setOrientation(QPrinter.Orientation.Portrait)
         self.document().print(printer)
-        qApp.restoreOverrideCursor()
+        QApplication.restoreOverrideCursor()
+        return
+
+    @pyqtSlot(str)
+    def navigateTo(self, anchor: str) -> None:
+        """Go to a specific #link in the document."""
+        logger.debug("Moving to anchor '#%s'", anchor)
+        self.setSource(QUrl(f"#{anchor}"))
         return
 
     ##
@@ -821,7 +927,7 @@ class _PreviewWidget(QTextBrowser):
         """Update the build time and the fuzzy age."""
         if self._docTime > 0:
             strBuildTime = "%s (%s)" % (
-                datetime.fromtimestamp(self._docTime).strftime("%x %X"),
+                CONFIG.localDateTime(datetime.fromtimestamp(self._docTime)),
                 fuzzyTime(int(time()) - self._docTime)
             )
         else:
@@ -859,3 +965,181 @@ class _PreviewWidget(QTextBrowser):
         return
 
 # END Class _PreviewWidget
+
+
+class _StatsWidget(QWidget):
+
+    def __init__(self, parent: QWidget) -> None:
+        super().__init__(parent=parent)
+
+        font = self.font()
+        font.setPointSizeF(0.9*SHARED.theme.fontPointSize)
+        self.setFont(font)
+
+        self.minWidget = QWidget(self)
+        self.maxWidget = QWidget(self)
+
+        self.toggleButton = NIconToggleButton(self, SHARED.theme.baseIconSize, "unfold")
+        self.toggleButton.toggled.connect(self._toggleView)
+
+        self._buildMinimal()
+        self._buildMaximal()
+
+        self.mainStack = QStackedWidget(self)
+        self.mainStack.addWidget(self.minWidget)
+        self.mainStack.addWidget(self.maxWidget)
+
+        self.outerBox = QHBoxLayout()
+        self.outerBox.addWidget(self.toggleButton, 0, QtAlignTop)
+        self.outerBox.addWidget(self.mainStack, 1, QtAlignTop)
+        self.outerBox.setContentsMargins(0, 0, 0, 0)
+
+        self.setLayout(self.outerBox)
+
+        self._toggleView(False)
+
+        return
+
+    def updateStats(self, data: dict[str, int]) -> None:
+        """Update the stats values from a Tokenizer stats dict."""
+        # Minimal
+        self.minWordCount.setText("{0:n}".format(data.get("allWords", 0)))
+        self.minCharCount.setText("{0:n}".format(data.get("allChars", 0)))
+
+        # Maximal
+        self.maxTotalWords.setText("{0:n}".format(data.get("allWords", 0)))
+        self.maxHeaderWords.setText("{0:n}".format(data.get("titleWords", 0)))
+        self.maxTextWords.setText("{0:n}".format(data.get("textWords", 0)))
+        self.maxTitleCount.setText("{0:n}".format(data.get("titleCount", 0)))
+        self.maxParCount.setText("{0:n}".format(data.get("paragraphCount", 0)))
+
+        self.maxTotalChars.setText("{0:n}".format(data.get("allChars", 0)))
+        self.maxHeaderChars.setText("{0:n}".format(data.get("titleChars", 0)))
+        self.maxTextChars.setText("{0:n}".format(data.get("textChars", 0)))
+
+        self.maxTotalWordChars.setText("{0:n}".format(data.get("allWordChars", 0)))
+        self.maxHeaderWordChars.setText("{0:n}".format(data.get("titleWordChars", 0)))
+        self.maxTextWordChars.setText("{0:n}".format(data.get("textWordChars", 0)))
+
+        return
+
+    ##
+    #  Private Slots
+    ##
+
+    @pyqtSlot(bool)
+    def _toggleView(self, state: bool) -> None:
+        """Toggle minimal or maximal view."""
+        ignored = QSizePolicy.Policy.Ignored
+        expanded = QSizePolicy.Policy.Expanding
+        if state:
+            self.mainStack.setCurrentWidget(self.maxWidget)
+            self.maxWidget.setSizePolicy(expanded, expanded)
+            self.minWidget.setSizePolicy(ignored, ignored)
+        else:
+            self.mainStack.setCurrentWidget(self.minWidget)
+            self.maxWidget.setSizePolicy(ignored, ignored)
+            self.minWidget.setSizePolicy(expanded, expanded)
+        self.maxWidget.adjustSize()
+        self.minWidget.adjustSize()
+        self.mainStack.adjustSize()
+        self.adjustSize()
+        return
+
+    ##
+    #  Internal Functions
+    ##
+
+    def _buildMinimal(self) -> None:
+        """Build the minimal stats page."""
+        mPx = CONFIG.pxInt(8)
+
+        self.lblWordCount = QLabel(self.tr("Words"), self)
+        self.minWordCount = QLabel(self)
+
+        self.lblCharCount = QLabel(self.tr("Characters"), self)
+        self.minCharCount = QLabel(self)
+
+        # Assemble
+        self.minLayout = QHBoxLayout()
+        self.minLayout.addWidget(self.lblWordCount)
+        self.minLayout.addWidget(self.minWordCount)
+        self.minLayout.addSpacing(mPx)
+        self.minLayout.addWidget(self.lblCharCount)
+        self.minLayout.addWidget(self.minCharCount)
+        self.minLayout.addStretch(1)
+        self.minLayout.setSpacing(mPx)
+        self.minLayout.setContentsMargins(0, 0, 0, 0)
+
+        self.minWidget.setLayout(self.minLayout)
+
+        return
+
+    def _buildMaximal(self) -> None:
+        """Build the maximal stats page."""
+        hPx = CONFIG.pxInt(12)
+        vPx = CONFIG.pxInt(4)
+
+        # Left Column
+        self.maxTotalWords = QLabel(self)
+        self.maxHeaderWords = QLabel(self)
+        self.maxTextWords = QLabel(self)
+        self.maxTitleCount = QLabel(self)
+        self.maxParCount = QLabel(self)
+
+        self.maxTotalWords.setAlignment(QtAlignRight)
+        self.maxHeaderWords.setAlignment(QtAlignRight)
+        self.maxTextWords.setAlignment(QtAlignRight)
+        self.maxTitleCount.setAlignment(QtAlignRight)
+        self.maxParCount.setAlignment(QtAlignRight)
+
+        self.leftForm = QFormLayout()
+        self.leftForm.addRow(self.tr("Words"), self.maxTotalWords)
+        self.leftForm.addRow(self.tr("Heading Words"), self.maxHeaderWords)
+        self.leftForm.addRow(self.tr("Body Text Words"), self.maxTextWords)
+        self.leftForm.addRow("", QLabel(self))
+        self.leftForm.addRow(self.tr("Headings"), self.maxTitleCount)
+        self.leftForm.addRow(self.tr("Paragraphs"), self.maxParCount)
+        self.leftForm.setHorizontalSpacing(hPx)
+        self.leftForm.setVerticalSpacing(vPx)
+
+        # Right Column
+        self.maxTotalChars = QLabel(self)
+        self.maxHeaderChars = QLabel(self)
+        self.maxTextChars = QLabel(self)
+
+        self.maxTotalWordChars = QLabel(self)
+        self.maxHeaderWordChars = QLabel(self)
+        self.maxTextWordChars = QLabel(self)
+
+        self.maxTotalChars.setAlignment(QtAlignRight)
+        self.maxHeaderChars.setAlignment(QtAlignRight)
+        self.maxTextChars.setAlignment(QtAlignRight)
+
+        self.maxTotalWordChars.setAlignment(QtAlignRight)
+        self.maxHeaderWordChars.setAlignment(QtAlignRight)
+        self.maxTextWordChars.setAlignment(QtAlignRight)
+
+        self.rightForm = QFormLayout()
+        self.rightForm.addRow(self.tr("Characters"), self.maxTotalChars)
+        self.rightForm.addRow(self.tr("Heading Characters"), self.maxHeaderChars)
+        self.rightForm.addRow(self.tr("Body Text Characters"), self.maxTextChars)
+        self.rightForm.addRow(self.tr("Characters, No Spaces"), self.maxTotalWordChars)
+        self.rightForm.addRow(self.tr("Heading Characters, No Spaces"), self.maxHeaderWordChars)
+        self.rightForm.addRow(self.tr("Body Text Characters, No Spaces"), self.maxTextWordChars)
+        self.rightForm.setHorizontalSpacing(hPx)
+        self.rightForm.setVerticalSpacing(vPx)
+
+        # Assemble
+        self.maxLayout = QHBoxLayout()
+        self.maxLayout.addLayout(self.leftForm)
+        self.maxLayout.addLayout(self.rightForm)
+        self.maxLayout.addStretch(1)
+        self.maxLayout.setSpacing(CONFIG.pxInt(32))
+        self.maxLayout.setContentsMargins(0, 0, 0, 0)
+
+        self.maxWidget.setLayout(self.maxLayout)
+
+        return
+
+# END Class _StatsWidget