novelWriter 2.2rc1__py3-none-any.whl → 2.3__py3-none-any.whl

novelwriter/tools/welcome.py

@@ -0,0 +1,819 @@
+"""
+novelWriter – GUI Welcome Dialog
+================================
+
+File History:
+Created: 2023-12-14 [2.3b1] GuiWelcome
+
+This file is a part of novelWriter
+Copyright 2018–2024, Veronica Berglyd Olsen
+
+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/>.
+"""
+from __future__ import annotations
+
+import logging
+
+from pathlib import Path
+from datetime import datetime
+
+from PyQt5.QtGui import QCloseEvent, QColor, QFont, QPaintEvent, QPainter, QPen
+from PyQt5.QtCore import (
+    QAbstractListModel, QEvent, QModelIndex, QObject, QPoint, QSize, Qt,
+    pyqtSignal, pyqtSlot
+)
+from PyQt5.QtWidgets import (
+    QAction, QDialog, QFileDialog, QFormLayout, QHBoxLayout, QLabel, QLineEdit,
+    QListView, QMenu, QPushButton, QScrollArea, QShortcut, QStackedWidget,
+    QStyle, QStyleOptionViewItem, QStyledItemDelegate, QToolButton,
+    QVBoxLayout, QWidget, qApp
+)
+
+from novelwriter import CONFIG, SHARED
+from novelwriter.enum import nwItemClass
+from novelwriter.common import formatInt, makeFileNameSafe
+from novelwriter.constants import nwFiles
+from novelwriter.core.coretools import ProjectBuilder
+from novelwriter.extensions.switch import NSwitch
+from novelwriter.extensions.modified import NSpinBox
+from novelwriter.extensions.versioninfo import VersionInfoWidget
+
+logger = logging.getLogger(__name__)
+
+PANEL_ALPHA = 0.7
+
+
+class GuiWelcome(QDialog):
+
+    openProjectRequest = pyqtSignal(Path)
+
+    def __init__(self, parent: QWidget) -> None:
+        super().__init__(parent=parent)
+
+        logger.debug("Create: GuiWelcome")
+        self.setObjectName("GuiWelcome")
+
+        self.setWindowTitle(self.tr("Welcome"))
+        self.setMinimumWidth(CONFIG.pxInt(650))
+        self.setMinimumHeight(CONFIG.pxInt(450))
+
+        hA = CONFIG.pxInt(8)
+        hB = CONFIG.pxInt(16)
+        hC = CONFIG.pxInt(24)
+        hD = CONFIG.pxInt(36)
+        hE = CONFIG.pxInt(48)
+        hF = CONFIG.pxInt(128)
+        self._hPx = CONFIG.pxInt(600)
+
+        self.resize(*CONFIG.welcomeWinSize)
+
+        # Elements
+        # ========
+
+        self.bgImage = SHARED.theme.loadDecoration("welcome")
+        self.nwImage = SHARED.theme.loadDecoration("nw-text", h=hD)
+        self.bgColor = QColor(255, 255, 255) if SHARED.theme.isLightTheme else QColor(54, 54, 54)
+
+        self.nwLogo = QLabel(self)
+        self.nwLogo.setPixmap(SHARED.theme.getPixmap("novelwriter", (hF, hF)))
+
+        self.nwLabel = QLabel(self)
+        self.nwLabel.setPixmap(self.nwImage)
+
+        self.nwInfo = VersionInfoWidget(self)
+
+        self.tabOpen = _OpenProjectPage(self)
+        self.tabOpen.openProjectRequest.connect(self._openProjectPath)
+
+        self.tabNew = _NewProjectPage(self)
+        self.tabNew.openProjectRequest.connect(self._openProjectPath)
+
+        self.mainStack = QStackedWidget(self)
+        self.mainStack.addWidget(self.tabOpen)
+        self.mainStack.addWidget(self.tabNew)
+
+        # Buttons
+        # =======
+
+        self.btnList = QPushButton(self.tr("List"), self)
+        self.btnList.setIcon(SHARED.theme.getIcon("list"))
+        self.btnList.clicked.connect(self._showOpenProjectPage)
+
+        self.btnNew = QPushButton(self.tr("New"), self)
+        self.btnNew.setIcon(SHARED.theme.getIcon("add"))
+        self.btnNew.clicked.connect(self._showNewProjectPage)
+
+        self.btnBrowse = QPushButton(self.tr("Browse"), self)
+        self.btnBrowse.setIcon(SHARED.theme.getIcon("browse"))
+        self.btnBrowse.clicked.connect(self._browseForProject)
+
+        self.btnCancel = QPushButton(self.tr("Cancel"), self)
+        self.btnCancel.setIcon(SHARED.theme.getIcon("cross"))
+        self.btnCancel.clicked.connect(self.close)
+
+        self.btnCreate = QPushButton(self.tr("Create"), self)
+        self.btnCreate.setIcon(SHARED.theme.getIcon("star"))
+        self.btnCreate.clicked.connect(self.tabNew.createNewProject)
+
+        self.btnOpen = QPushButton(self.tr("Open"), self)
+        self.btnOpen.setIcon(SHARED.theme.getIcon("open"))
+        self.btnOpen.clicked.connect(self._openSelectedItem)
+
+        self.btnBox = QHBoxLayout()
+        self.btnBox.addStretch(1)
+        self.btnBox.addWidget(self.btnList)
+        self.btnBox.addWidget(self.btnNew)
+        self.btnBox.addWidget(self.btnBrowse)
+        self.btnBox.addWidget(self.btnCancel)
+        self.btnBox.addWidget(self.btnCreate)
+        self.btnBox.addWidget(self.btnOpen)
+        self._setButtonVisibility()
+
+        # Assemble
+        # ========
+
+        self.innerBox = QVBoxLayout()
+        self.innerBox.addSpacing(hB)
+        self.innerBox.addWidget(self.nwLabel)
+        self.innerBox.addWidget(self.nwInfo)
+        self.innerBox.addSpacing(hA)
+        self.innerBox.addWidget(self.mainStack)
+        self.innerBox.addSpacing(hB)
+        self.innerBox.addLayout(self.btnBox)
+
+        topRight = Qt.AlignmentFlag.AlignTop | Qt.AlignmentFlag.AlignRight
+
+        self.outerBox = QHBoxLayout()
+        self.outerBox.addWidget(self.nwLogo, 3, topRight)
+        self.outerBox.addLayout(self.innerBox, 9)
+        self.outerBox.setContentsMargins(hF, hE, hC, hE)
+
+        self.setLayout(self.outerBox)
+        self.setSizeGripEnabled(True)
+
+        logger.debug("Ready: GuiWelcome")
+
+        return
+
+    def __del__(self) -> None:  # pragma: no cover
+        logger.debug("Delete: GuiWelcome")
+        return
+
+    ##
+    #  Events
+    ##
+
+    def paintEvent(self, event: QPaintEvent) -> None:
+        """Overload the paint event to draw the background image."""
+        hWin = self.height()
+        hPix = min(hWin, self._hPx)
+        tMode = Qt.TransformationMode.SmoothTransformation
+        painter = QPainter(self)
+        painter.fillRect(self.rect(), self.bgColor)
+        painter.drawPixmap(0, hWin - hPix, self.bgImage.scaledToHeight(hPix, tMode))
+        super().paintEvent(event)
+        return
+
+    def closeEvent(self, event: QCloseEvent) -> None:
+        """Capture the user closing the window and save settings."""
+        self._saveSettings()
+        event.accept()
+        self.deleteLater()
+        return
+
+    ##
+    #  Private Slots
+    ##
+
+    @pyqtSlot()
+    def _showNewProjectPage(self) -> None:
+        """Show the create new project page."""
+        self.mainStack.setCurrentWidget(self.tabNew)
+        self._setButtonVisibility()
+        return
+
+    @pyqtSlot()
+    def _showOpenProjectPage(self) -> None:
+        """Show the open exiting project page."""
+        self.mainStack.setCurrentWidget(self.tabOpen)
+        self._setButtonVisibility()
+        return
+
+    @pyqtSlot()
+    def _browseForProject(self) -> None:
+        """Browse for a project to open."""
+        if path := SHARED.getProjectPath(self, path=CONFIG.lastPath(), allowZip=False):
+            CONFIG.setLastPath(path)
+            self._openProjectPath(path)
+        return
+
+    @pyqtSlot()
+    def _openSelectedItem(self) -> None:
+        """Open the currently selected project item."""
+        if self.mainStack.currentWidget() == self.tabOpen:
+            self.tabOpen.openSelectedItem()
+        return
+
+    @pyqtSlot(Path)
+    def _openProjectPath(self, path: Path) -> None:
+        """Emit a project open signal."""
+        if isinstance(path, Path):
+            # Hide before emitting the open project signal so that any
+            # close/backup dialogs don't pop up over it.
+            self.hide()
+            self.openProjectRequest.emit(path)
+        self.close()
+        return
+
+    ##
+    #  Internal Functions
+    ##
+
+    def _saveSettings(self) -> None:
+        """Save the user GUI settings."""
+        logger.debug("Saving State: GuiWelcome")
+        CONFIG.setWelcomeWinSize(self.width(), self.height())
+        return
+
+    def _setButtonVisibility(self) -> None:
+        """Change the visibility of the dialog buttons."""
+        listMode = self.mainStack.currentWidget() == self.tabOpen
+        self.btnList.setVisible(not listMode)
+        self.btnNew.setVisible(listMode)
+        self.btnBrowse.setVisible(listMode)
+        self.btnCreate.setVisible(not listMode)
+        self.btnOpen.setVisible(listMode)
+        if listMode:
+            self.btnOpen.setFocus()
+        else:
+            self.btnCreate.setFocus()
+        return
+
+# END Class GuiWelcome
+
+
+class _OpenProjectPage(QWidget):
+
+    openProjectRequest = pyqtSignal(Path)
+
+    def __init__(self, parent: QWidget) -> None:
+        super().__init__(parent=parent)
+
+        # List View
+        self.listModel = _ProjectListModel(self)
+        self.itemDelegate = _ProjectListItem(self)
+
+        self.listWidget = QListView(self)
+        self.listWidget.setItemDelegate(self.itemDelegate)
+        self.listWidget.setModel(self.listModel)
+        self.listWidget.setContextMenuPolicy(Qt.ContextMenuPolicy.CustomContextMenu)
+        self.listWidget.clicked.connect(self._projectClicked)
+        self.listWidget.doubleClicked.connect(self._projectDoubleClicked)
+        self.listWidget.customContextMenuRequested.connect(self._openContextMenu)
+
+        # Info / Tool
+        self.aMissing = QAction(self)
+        self.aMissing.setIcon(SHARED.theme.getIcon("alert_warn"))
+        self.aMissing.setToolTip(self.tr("The project path is not reachable."))
+
+        self.selectedPath = QLineEdit(self)
+        self.selectedPath.setReadOnly(True)
+        self.selectedPath.addAction(self.aMissing, QLineEdit.ActionPosition.TrailingPosition)
+
+        self.keyDelete = QShortcut(self)
+        self.keyDelete.setKey(Qt.Key.Key_Delete)
+        self.keyDelete.activated.connect(self._deleteSelectedItem)
+
+        # Assemble
+        self.outerBox = QVBoxLayout()
+        self.outerBox.addWidget(self.listWidget)
+        self.outerBox.addWidget(self.selectedPath)
+        self.outerBox.setContentsMargins(0, 0, 0, 0)
+
+        self.setLayout(self.outerBox)
+
+        self._selectFirstItem()
+
+        baseCol = self.palette().base().color()
+        self.setStyleSheet((
+            "QListView {{border: none; background: rgba({r},{g},{b},{a});}} "
+            "QLineEdit {{border: none; background: rgba({r},{g},{b},{a}); padding: {m}px;}} "
+        ).format(r=baseCol.red(), g=baseCol.green(), b=baseCol.blue(),
+                 a=PANEL_ALPHA, m=CONFIG.pxInt(4)))
+
+        return
+
+    ##
+    #  Public Slots
+    ##
+
+    @pyqtSlot()
+    def openSelectedItem(self) -> None:
+        """Open the currently selected project item."""
+        if (selection := self.listWidget.selectedIndexes()) and (index := selection[0]).isValid():
+            self.openProjectRequest.emit(Path(str(index.data()[1])))
+        return
+
+    ##
+    #  Private Slots
+    ##
+
+    @pyqtSlot(QModelIndex)
+    def _projectClicked(self, index: QModelIndex) -> None:
+        """Process single click on project item."""
+        path = self.tr("Path")
+        value = index.data()[1] if index.isValid() else ""
+        text = f"{path}: {value}"
+        self.selectedPath.setText(text)
+        self.selectedPath.setToolTip(text)
+        self.selectedPath.setCursorPosition(0)
+        self.aMissing.setVisible(not (Path(value) / nwFiles.PROJ_FILE).is_file())
+        return
+
+    @pyqtSlot(QModelIndex)
+    def _projectDoubleClicked(self, index: QModelIndex) -> None:
+        """Process double click on project item."""
+        if index.isValid():
+            self.openProjectRequest.emit(Path(str(index.data()[1])))
+        return
+
+    @pyqtSlot()
+    def _deleteSelectedItem(self) -> None:
+        """Delete the currently selected project item."""
+        if (selection := self.listWidget.selectedIndexes()) and (index := selection[0]).isValid():
+            text = self.tr(
+                "Remove '{0}' from the recent projects list? "
+                "The project files will not be deleted."
+            ).format(index.data()[0])
+            if SHARED.question(text):
+                self.listModel.removeEntry(index)
+            self._selectFirstItem()
+        return
+
+    @pyqtSlot("QPoint")
+    def _openContextMenu(self, pos: QPoint) -> None:
+        """Open the custom context menu."""
+        ctxMenu = QMenu(self)
+        ctxMenu.setObjectName("ContextMenu")  # Used for testing
+        action = ctxMenu.addAction(self.tr("Open Project"))
+        action.triggered.connect(self.openSelectedItem)
+        action = ctxMenu.addAction(self.tr("Remove Project"))
+        action.triggered.connect(self._deleteSelectedItem)
+        ctxMenu.exec_(self.mapToGlobal(pos))
+        ctxMenu.deleteLater()
+        return
+
+    ##
+    #  Internal Functions
+    ##
+
+    def _selectFirstItem(self) -> None:
+        """Select the first item, if any are available."""
+        index = self.listModel.index(0)
+        self.listWidget.setCurrentIndex(index)
+        self._projectClicked(index)
+        return
+
+# END Class _OpenProjectPage
+
+
+class _ProjectListItem(QStyledItemDelegate):
+
+    __slots__ = ("_pPx", "_hPx", "_tFont", "_dFont", "_dPen", "_icon")
+
+    def __init__(self, parent: QWidget) -> None:
+        super().__init__(parent=parent)
+
+        fPx = SHARED.theme.fontPixelSize
+        fPt = SHARED.theme.fontPointSize
+        tPx = round(1.2 * fPx)
+        mPx = CONFIG.pxInt(4)
+        iPx = tPx + fPx
+
+        self._pPx = (mPx//2, 3*mPx//2, iPx + mPx, mPx, mPx + tPx)  # Painter coordinates
+        self._hPx = 2*mPx + tPx + fPx  # Fixed height
+
+        self._tFont = qApp.font()
+        self._tFont.setPointSizeF(1.2*fPt)
+        self._tFont.setWeight(QFont.Weight.Bold)
+
+        self._dFont = qApp.font()
+        self._dFont.setPointSizeF(fPt)
+        self._dPen = QPen(SHARED.theme.helpText)
+
+        self._icon = SHARED.theme.getPixmap("proj_nwx", (iPx, iPx))
+
+        return
+
+    def paint(self, painter: QPainter, opt: QStyleOptionViewItem, index: QModelIndex) -> None:
+        """Paint a project entry on the canvas."""
+        rect = opt.rect
+        title, _, details = index.data()
+        tFlag = Qt.TextFlag.TextSingleLine
+        ix, iy, x, y1, y2 = self._pPx
+
+        painter.save()
+        if opt.state & QStyle.StateFlag.State_Selected == QStyle.StateFlag.State_Selected:
+            painter.setOpacity(0.25)
+            painter.fillRect(rect, qApp.palette().highlight())
+            painter.setOpacity(1.0)
+
+        painter.drawPixmap(ix, rect.top() + iy, self._icon)
+        painter.setFont(self._tFont)
+        painter.drawText(rect.adjusted(x, y1, 0, 0), tFlag, title)
+        painter.setFont(self._dFont)
+        painter.setPen(self._dPen)
+        painter.drawText(rect.adjusted(x, y2, 0, 0), tFlag, details)
+        painter.restore()
+
+        return
+
+    def sizeHint(self, opt: QStyleOptionViewItem, index: QModelIndex) -> QSize:
+        """Set the size hint to fixed height."""
+        return QSize(opt.rect.width(), self._hPx)
+
+# END Class _ProjectListItem
+
+
+class _ProjectListModel(QAbstractListModel):
+
+    def __init__(self, parent: QObject) -> None:
+        super().__init__(parent=parent)
+        data = []
+        words = self.tr("Word Count")
+        opened = self.tr("Last Opened")
+        records = sorted(CONFIG.recentProjects.listEntries(), key=lambda x: x[3], reverse=True)
+        for path, title, count, time in records:
+            when = datetime.fromtimestamp(time).strftime("%x")
+            data.append((title, path, f"{opened}: {when}, {words}: {formatInt(count)}"))
+        self._data = data
+        return
+
+    def rowCount(self, parent: QModelIndex | None = None) -> int:
+        """Return the size of the model."""
+        return len(self._data)
+
+    def data(self, index: QModelIndex, role: int = 0) -> tuple[str, str, str]:
+        """Return data for an individual item."""
+        try:
+            return self._data[index.row()] if index.isValid() else ("", "", "")
+        except IndexError:
+            return "", "", ""
+
+    def removeEntry(self, index: QModelIndex) -> bool:
+        """Remove an entry in the model."""
+        if index.isValid() and (path := index.data()[1]):
+            try:
+                self.beginRemoveRows(index.parent(), index.row(), index.row())
+                self._data.pop(index.row())
+                self.endRemoveRows()
+            except IndexError:
+                return False
+            CONFIG.recentProjects.remove(path)
+            return True
+        return False
+
+# END Class _ProjectListModel
+
+
+class _NewProjectPage(QWidget):
+
+    openProjectRequest = pyqtSignal(Path)
+
+    def __init__(self, parent: QWidget) -> None:
+        super().__init__(parent=parent)
+
+        # Main Form
+        # =========
+
+        self.projectForm = _NewProjectForm(self)
+
+        self.scrollArea = QScrollArea(self)
+        self.scrollArea.setWidget(self.projectForm)
+        self.scrollArea.setWidgetResizable(True)
+        self.scrollArea.setHorizontalScrollBarPolicy(Qt.ScrollBarPolicy.ScrollBarAsNeeded)
+        self.scrollArea.setVerticalScrollBarPolicy(Qt.ScrollBarPolicy.ScrollBarAsNeeded)
+
+        # Assemble
+        # ========
+
+        self.outerBox = QVBoxLayout()
+        self.outerBox.addWidget(self.scrollArea)
+        self.outerBox.setContentsMargins(0, 0, 0, 0)
+
+        self.setLayout(self.outerBox)
+
+        # Styles
+        # ======
+
+        baseCol = self.palette().base().color()
+        self.setStyleSheet((
+            "QScrollArea {{border: none; background: rgba({r},{g},{b},{a});}} "
+            "_NewProjectForm {{border: none; background: rgba({r},{g},{b},{a});}} "
+        ).format(r=baseCol.red(), g=baseCol.green(), b=baseCol.blue(), a=PANEL_ALPHA))
+
+        return
+
+    ##
+    #  Public Slots
+    ##
+
+    @pyqtSlot()
+    def createNewProject(self) -> None:
+        """Create a new project from the data in the form."""
+        data = self.projectForm.getProjectData()
+        if not data.get("name"):
+            SHARED.error(self.tr("A project name is required."))
+            return
+        builder = ProjectBuilder()
+        if builder.buildProject(data) and (path := builder.projPath):
+            self.openProjectRequest.emit(path)
+        return
+
+# END Class _NewProjectPage
+
+
+class _NewProjectForm(QWidget):
+
+    FILL_BLANK = 0
+    FILL_SAMPLE = 1
+    FILL_COPY = 2
+
+    def __init__(self, parent: QWidget) -> None:
+        super().__init__(parent=parent)
+
+        self._basePath = CONFIG.lastPath()
+        self._fillMode = self.FILL_BLANK
+        self._copyPath = None
+
+        iPx = SHARED.theme.baseIconSize
+        sPx = CONFIG.pxInt(16)
+
+        # Project Settings
+        # ================
+
+        # Project Name
+        self.projName = QLineEdit(self)
+        self.projName.setMaxLength(200)
+        self.projName.setPlaceholderText(self.tr("Required"))
+        self.projName.textChanged.connect(self._updateProjPath)
+
+        # Author(s)
+        self.projAuthor = QLineEdit(self)
+        self.projAuthor.setMaxLength(200)
+        self.projAuthor.setPlaceholderText(self.tr("Optional"))
+
+        # Project Path
+        self.projPath = QLineEdit(self)
+        self.projPath.setReadOnly(True)
+
+        self.browsePath = QToolButton(self)
+        self.browsePath.setIcon(SHARED.theme.getIcon("browse"))
+        self.browsePath.clicked.connect(self._doBrowse)
+
+        self.pathBox = QHBoxLayout()
+        self.pathBox.addWidget(self.projPath)
+        self.pathBox.addWidget(self.browsePath)
+
+        # Fill Project
+        self.projFill = QLineEdit(self)
+        self.projFill.setReadOnly(True)
+
+        self.browseFill = QToolButton(self)
+        self.browseFill.setIcon(SHARED.theme.getIcon("add_document"))
+
+        self.fillMenu = _PopLeftDirectionMenu(self.browseFill)
+
+        self.fillBlank = self.fillMenu.addAction(self.tr("Create a fresh project"))
+        self.fillBlank.setIcon(SHARED.theme.getIcon("document"))
+        self.fillBlank.triggered.connect(self._setFillBlank)
+
+        self.fillSample = self.fillMenu.addAction(self.tr("Create an example project"))
+        self.fillSample.setIcon(SHARED.theme.getIcon("add_document"))
+        self.fillSample.triggered.connect(self._setFillSample)
+
+        self.fillCopy = self.fillMenu.addAction(self.tr("Copy an existing project"))
+        self.fillCopy.setIcon(SHARED.theme.getIcon("browse"))
+        self.fillCopy.triggered.connect(self._setFillCopy)
+
+        self.browseFill.setMenu(self.fillMenu)
+        self.browseFill.setPopupMode(QToolButton.ToolButtonPopupMode.InstantPopup)
+
+        self.fillBox = QHBoxLayout()
+        self.fillBox.addWidget(self.projFill)
+        self.fillBox.addWidget(self.browseFill)
+
+        # Project Form
+        self.projectForm = QFormLayout()
+        self.projectForm.setAlignment(Qt.AlignmentFlag.AlignLeft)
+        self.projectForm.addRow(self.tr("Project Name"), self.projName)
+        self.projectForm.addRow(self.tr("Author"), self.projAuthor)
+        self.projectForm.addRow(self.tr("Project Path"), self.pathBox)
+        self.projectForm.addRow(self.tr("Prefill Project"), self.fillBox)
+
+        # Chapters and Scenes
+        # ===================
+
+        self.numChapters = NSpinBox(self)
+        self.numChapters.setRange(0, 200)
+        self.numChapters.setValue(5)
+        self.numChapters.setToolTip(self.tr("Set to 0 to only add scenes"))
+
+        self.chapterBox = QHBoxLayout()
+        self.chapterBox.addWidget(QLabel(self.tr("Add")))
+        self.chapterBox.addWidget(self.numChapters)
+        self.chapterBox.addWidget(QLabel(self.tr("chapter documents")))
+        self.chapterBox.addStretch(1)
+
+        self.numScenes = NSpinBox(self)
+        self.numScenes.setRange(0, 200)
+        self.numScenes.setValue(5)
+
+        self.sceneBox = QHBoxLayout()
+        self.sceneBox.addWidget(QLabel(self.tr("Add")))
+        self.sceneBox.addWidget(self.numScenes)
+        self.sceneBox.addWidget(QLabel(self.tr("scene documents (to each chapter)")))
+        self.sceneBox.addStretch(1)
+
+        self.novelForm = QVBoxLayout()
+        self.novelForm.addLayout(self.chapterBox)
+        self.novelForm.addLayout(self.sceneBox)
+
+        # Project Notes
+        # =============
+
+        self.addPlot = NSwitch(self, height=iPx)
+        self.addPlot.setChecked(True)
+        self.addPlot.clicked.connect(self._syncSwitches)
+
+        self.addChar = NSwitch(self, height=iPx)
+        self.addChar.setChecked(True)
+        self.addChar.clicked.connect(self._syncSwitches)
+
+        self.addWorld = NSwitch(self, height=iPx)
+        self.addWorld.setChecked(False)
+        self.addWorld.clicked.connect(self._syncSwitches)
+
+        self.addNotes = NSwitch(self, height=iPx)
+        self.addNotes.setChecked(False)
+
+        self.notesForm = QFormLayout()
+        self.notesForm.setAlignment(Qt.AlignmentFlag.AlignLeft)
+        self.notesForm.addRow(self.tr("Add a folder for plot notes"), self.addPlot)
+        self.notesForm.addRow(self.tr("Add a folder for character notes"), self.addChar)
+        self.notesForm.addRow(self.tr("Add a folder for location notes"), self.addWorld)
+        self.notesForm.addRow(self.tr("Add example notes to the above"), self.addNotes)
+
+        # Assemble
+        # ========
+
+        self.extraBox = QVBoxLayout()
+        self.extraBox.addWidget(QLabel("<b>{0}</b>".format(self.tr("Chapters and Scenes"))))
+        self.extraBox.addLayout(self.novelForm)
+        self.extraBox.addSpacing(sPx)
+        self.extraBox.addWidget(QLabel("<b>{0}</b>".format(self.tr("Project Notes"))))
+        self.extraBox.addLayout(self.notesForm)
+        self.extraBox.setContentsMargins(0, 0, 0, 0)
+
+        self.extraWidget = QWidget(self)
+        self.extraWidget.setLayout(self.extraBox)
+        self.extraWidget.setContentsMargins(0, 0, 0, 0)
+
+        self.formBox = QVBoxLayout()
+        self.formBox.addWidget(QLabel("<b>{0}</b>".format(self.tr("Create New Project"))))
+        self.formBox.addLayout(self.projectForm)
+        self.formBox.addSpacing(sPx)
+        self.formBox.addWidget(self.extraWidget)
+        self.formBox.addStretch(1)
+
+        self.setLayout(self.formBox)
+
+        self._updateProjPath()
+        self._updateFillInfo()
+
+        return
+
+    def getProjectData(self) -> dict:
+        """Collect form data and return it as a dictionary."""
+        roots = []
+        if self.addPlot.isChecked():
+            roots.append(nwItemClass.PLOT)
+        if self.addChar.isChecked():
+            roots.append(nwItemClass.CHARACTER)
+        if self.addWorld.isChecked():
+            roots.append(nwItemClass.WORLD)
+        return {
+            "name": self.projName.text().strip(),
+            "author": self.projAuthor.text().strip(),
+            "path": self.projPath.text(),
+            "blank": self._fillMode == self.FILL_BLANK,
+            "sample": self._fillMode == self.FILL_SAMPLE,
+            "template": self._copyPath if self._fillMode == self.FILL_COPY else None,
+            "chapters": self.numChapters.value(),
+            "scenes": self.numScenes.value(),
+            "roots": roots,
+            "notes": self.addNotes.isChecked(),
+        }
+
+    ##
+    #  Private Slots
+    ##
+
+    @pyqtSlot()
+    def _doBrowse(self) -> None:
+        """Select a project folder."""
+        if projDir := QFileDialog.getExistingDirectory(
+            self, self.tr("Select Project Folder"),
+            str(self._basePath), options=QFileDialog.ShowDirsOnly
+        ):
+            self._basePath = Path(projDir)
+            self._updateProjPath()
+            CONFIG.setLastPath(self._basePath)
+        return
+
+    @pyqtSlot()
+    def _updateProjPath(self) -> None:
+        """Update the path box to show the full project path."""
+        projName = makeFileNameSafe(self.projName.text().strip())
+        self.projPath.setText(str(self._basePath / projName))
+        return
+
+    @pyqtSlot()
+    def _syncSwitches(self):
+        """Check if the add notes option should also be switched off."""
+        addPlot = self.addPlot.isChecked()
+        addChar = self.addChar.isChecked()
+        addWorld = self.addWorld.isChecked()
+        if not (addPlot or addChar or addWorld):
+            self.addNotes.setChecked(False)
+        return
+
+    @pyqtSlot()
+    def _setFillBlank(self) -> None:
+        """Set fill mode to blank project."""
+        self._fillMode = self.FILL_BLANK
+        self._updateFillInfo()
+        return
+
+    @pyqtSlot()
+    def _setFillSample(self) -> None:
+        """Set fill mode to sample project."""
+        self._fillMode = self.FILL_SAMPLE
+        self._updateFillInfo()
+        return
+
+    @pyqtSlot()
+    def _setFillCopy(self) -> None:
+        """Set fill mode to copy project."""
+        if copyPath := SHARED.getProjectPath(self, allowZip=True):
+            self._fillMode = self.FILL_COPY
+            self._copyPath = copyPath
+            self._updateFillInfo()
+        return
+
+    ##
+    #  Internal Functions
+    ##
+
+    def _updateFillInfo(self) -> None:
+        """Update the text of the project fill box."""
+        text = ""
+        if self._fillMode == self.FILL_BLANK:
+            text = self.tr("Fresh Project")
+        elif self._fillMode == self.FILL_SAMPLE:
+            text = self.tr("Example Project")
+        elif self._fillMode == self.FILL_COPY:
+            text = self.tr("Template: {0}").format(str(self._copyPath))
+
+        self.projFill.setText(text)
+        self.projFill.setToolTip(text)
+        self.projFill.setCursorPosition(0)
+        self.extraWidget.setVisible(self._fillMode == self.FILL_BLANK)
+
+        return
+
+# END Class _NewProjectForm
+
+
+class _PopLeftDirectionMenu(QMenu):
+
+    def event(self, event: QEvent) -> bool:
+        """Overload the show event and move the menu popup location."""
+        if event.type() == QEvent.Show:
+            if isinstance(parent := self.parent(), QWidget):
+                offset = QPoint(parent.width() - self.width(), parent.height())
+                self.move(parent.mapToGlobal(offset))
+        return super(_PopLeftDirectionMenu, self).event(event)
+
+# END Class _PopLeftDirectionMenu